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KEEP THIS UPDATE NOTICE IN YOUR MANUAL TO MAINTAIN AN UP-TO-DATE 
RECORD OF CHANGES. 

TYPE AND IDENTIFICATION OF DOCUMENTATION CHANGES. 

Five types of changes are used to update documents contained in the TOPS-20 software manuals. 
Change symbols and notations are used to specify where, when, and why alterations were made to 
each update page. The five types of update changes and the manner in which each is identified are 
described in the following table. 


The Following Symbols and/or Notations 

1. Change bar in outside margin; version num- 
ber and change date printed at bottom of 
page. 

2. Change bar in outside margin; change date 
printed at bottom of page. 

3. Change date printed at bottom of page. 

4. Bullet (•) in outside margin; version number 
and change date printed at bottom of page. 

5. Bullet (•) in outside margin; change date 
printed at bottom of page. 


Identify the Following Types of Update Changes 

1. Changes were required by a new version of 
the software being described. 

2. Changes were required to either clarify or 
correct the existing material. 

3. Changes were made for editorial purposes 
but use of the software is not affected. 

4. Data was deleted to comply with a new ver- 
sion of the software being described. 

5. Data was deleted to either clarify or correct 
the existing material. 
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PREFACE 


The TOPS-20 Comm ands Reference Manual is an alphabetically arranged 
description of all operating system commands (EXEC commands) available 
to the non-pr ivileged timesharing user of TOPS-20. In this manual 
each command description contains appropriate parts chosen from the 
following list: 


Function 

Format 

Output 

Characteristics 

Hints 

Special Cases 
Restr ictions 
Warning 

Effect on Memory and Terminal 

Related Commands 


a brief statement of the 
command's purpose 

a single formalized example, 
including guidewords, showing 
where various arguments are 
needed to complete the 
command's meaning. Lists of 
possible arguments follow this 
example, with explanations of 
each 

explanation, where necessary, 
of terminal or disk output 
resulting from the command 

description of important 

features of command use 

suggestions for employing the 
command effectively 

description of command behavior 
in certain unusual situations 

limitations or peculiarities of 
the command 

powerful functions the command 
may perform 

changes to memory and to the 
state of your terminal 
resulting from the command 

names of other commands 
associated with the given 
command 


Vll 


Examples 


several real examples that 
illustrate the main 
applications of the command in 
timesharing use. The 
characters that you would type 
are underlined in these 
examples . 

In addition, there are two appendixes for quick reference - a 
list of commands grouped by function, and an alphabetical summary 
of commands showing what variety of argument each uses and 
whether it calls a program or otherwise affects memory. 


To use the TQPS-20 Commands Reference Manual properly, you should 
first read and understand Getting Started With TOPS-20 and the TOPS-?n 

User s Guide. The occasional summary of information you will fiHd 

here cannot substitute for the more complete presentations offered in 
those manuals. 
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INTRODUCTION 


COMMANDS AND ARGUMENTS 

A complete TOPS-20 command consists of the command name and usually 
one or more arguments. In the most general sense, arguments are any 
combinations of letters, numerals, punctuation marks and other 
characters that you type after the command name itself to complete the 
meaning of the command. These arguments can be file specifications, 
switches, subcommands, and values for switches and subcommands, as 
well as words and numbers (the arguments to the SET and TERMINAL 
commands, for example). The following pages contain general 
information about each variety of argument. 


File Specifications 

Information and programs for TOPS-20 are usually stored in uniquely 
labeled files. Therefore, file specifications or "filespecs" are the 
most common variety of argument to a command. A complete file 
specification is of the form 

dev : <d i r>name . typ . gen ; at.t ; . . . ; a 1 1 

where 

dev: is a device (usually a file structure) 

<dir> is a directory name 
name is a filename 

.typ is a file type 

.gen is a generation number 

;att is a file attribute 

You need file attributes in only a few situations and can usually let 
dev:, <dir>, and .gen take default values (that is, values defined by 
the state of your job - see the Special Features section below) , so 
you can give most file specifications in the shortened form name. typ 
without being unclear. In a few cases, an entire file specification 
is assumed if you do not supply one when you give the command (for the 
CREATE and EDIT commands, for example, and for LOAD-class 
commands - COMPILE, LOAD, EXECUTE, and DEBUG). 
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Whenever you omit the dev: field of the filespec, the system assumes 
you mean your connected structure (DSK:). This is the public 
structure (usually named PS:), which all users must log in to, unless 
you connect to a directory on another structure by using the CONNECT 
command. Give the INFORMATION STRUCTURE command if you are unsure of 
the name for your connected structure. 

Whenever you omit the <dir> field of the filespec, the system assumes 
you mean your connected directory. Unless you have given a CONNECT 
command, this is your "log-in" directory, the directory on the public 
structure that you must loq in to and which usually has a name 
composed of your surname, or surname and initials, enclosed in angle 
brackets. You change your connected directory by giving a CONNECT 
command. Use the DIRECTORY command to see the name of your connected 
d i rectory . 

When you omit the .gen field of the filespec the system usually 
assumes you mean the highest generation (largest generation number) of 
the file. (A few commands, for example, DELETE, RENAME, and 
DIRECTORY, act on all generations of a file unless you specify a 
particular generation.) When you create and edit text files, compile 
and debug programs, or do anything else to produce another generation 
of a file, the system automatically works with the highest existing 
generation and labels the changed file with the next higher generation 
number. Therefore when you omit the generation number in a filespec 
given as argument to a TOPS-20 command, you are assured of using the 
most recent version of the file. Although you can override this 
default action by specifying particular generations of input and 
output files, it is simplest and most straightforward to allow the 
defaults to prevail. 

Specification of file attributes is optional. You can assign 
attributes in order to have a file automatically marked for deletion 
when you log out; to associate a file with a valid account; and so 
forth. Appendix C lists the available file attributes. 

Pressing the ESC key instead of typing a filespec field will usually 
cause any default for the remaining fields to be printed on your 
terminal . 

There are two characters (called "wildcard" characters) that you can 
include in any field of a filespec to include all files matching the 
rest of the filespec. An asterisk (*) fills in for zero or more 
characters of a field, while a percent sign (%) fills in for a single 
character only. (However, only the complete field "DSK*:" is allowed 
as wildcard for the device field, and only the complete field "*" is 
allowed as wildcard for the generation field.) Therefore you could 
give the command DIRECTORY *.CBL to find out what source files written 
in COBOL are in your connected directory, or the command DELETE *.Q* 
to remove the EDIT program's backup files from your directory. 


Switches 

Switches are arguments used with LOAD-class (COMPILE, LOAD, EXECUTE, 
and DEBUG) and EDIT-class (CREATE and EDIT) commands, as well as with 
Queue-class commands - that is, those affecting entries in processing 
queues (CANCEL, DISMOUNT, MODIFY, MOUNT, PLOT, PRINT, PUNCH, and 
SUBMIT) . 

Switches can also be used with the following program-control commands: 
DDT, GET, MERGE, R, and RUN. The REWIND command also accepts a 
swi tch . 
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Switches allow you to give quickly many options chosen from a large 
list, and let you specify to which files they apply when you give more 
than one filespec in a single command. 

Give switches on the same line as the command, typing a slash (/) 
before each switch. If your command requires more than one line, 
simply keep typing without giving a carriage return. The system will 
begin a new line automatically and will read your command as if you 
had typed it on a single line. Or you may end your command line at 
any point with a hyphen (-) and carriage return, and continue the 
command on the next line; the hyphen will not be considered part of 
your input. 

Keep in mind the way each class of command considers switches. 
EDIT-class commands operate on only one file at a time, and the 
switches must be given before the input filespec - this is the 
simplest case. 

Queue-class and LOAD-class commands treat switches according to their 
position in the command line. If you give them before any filespecs, 
they act as default switches for all filespecs in the command (i.e., 
they will be in effect unless you override them with later switches 
applying to individual files only) . If you give them after the first 
filespec, they apply only to the nearest preceding file. In addition, 
there are a few switches of a different sort for the PLOT, PRINT, and 
PUNCH commands - these apply to all files no matter where they appear 
in the command line. These are called job switches (because they 
affect the entire printing job) and are presented in a separate list 
in those command descriptions. 

A switch is a default if the system assumes it in the absence of 
others. For LOAD-class commands, /FORTRAN is the default for the four 
switches (/FORTRAN, /MACRO, /COBOL, and /ALGOL) specifying which 
compiler to use. The /NOCOMPILE switch is the default for /COMPILE, 
/NOCOMPILE, and /RELOCATABLE. Most defaults for these commands apply 
to only a pair of switches, however: the /BINARY, /NOSEARCH, and 
/NOOPTIMIZE switches are assumed, for example, unless you specify 
/NOBINARY, /SEARCH, and /OPTIMIZE. The /MAP switch is not a default 
switch, but there is a default argument for /MAP if you give the 
switch without specifying an argument. 

Default switches for the other classes of command operate similarly. 
Some are in effect unless you specify their opposite; others are in 
effect with a default argument unless you specify another argument; 
still others must be specified to be in effect, but are supplied with 
a default argument. The list of switches presented with each command 
description distinguishes these cases. When you give two or more 
switches of the same kind (for example, /BINARY and /NOBINARY) , the 
last switch given usually prevails. 


Subcommands 

Subcommands are a. variety of argument used chiefly with 
DIRECTORY-class (DIRECTORY, FDIRECTORY , TDIRECTORY, and VDIRECTORY) 
commands and with the BUILD command. The COPY and APPEND commands 
share a small group of subcommands that modify their operation, and 
ARCHIVE, DELETE, EXPUNGE, SYSTAT, and TAKE each have subcommands. 
However, you usually employ these last seven commands without 
resorting to subcommands at all. 
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If you want to give subcommands to any of the DIRECTOFY-class 
commands, type a comma at the end of the command line just before 
pressing the carriage return. After the system prompts you with a 
double at sign (@@) you can give subcommands, one on each line. If 
you give no subcommands to the DIRECTORY command, the ALPHABETICAL and 
HEADING subcommands will be in effect, giving an alphabetical listing 
of files. For a few subcommands, default arguments will be in effect 
if you give the subcommands without supplying any. You can give 
subcommands in any order, requesting or declining special categories 
of information and specifying the format of its presentation. If you 
give mutually exclusive subcommands (ALPHABETICAL and CHRONOLOGICAL, 
for example) the last-given subcommand prevails. Note that the 
FDIRECTORY , TDIRECTORY , and VDIRECTORY commands are equivalent to the 
DIRECTORY command with certain subcommands automatically included, and 
can be further modified with other subcommands from DIRECTORY'S list. 
To cancel a DIRECTORY-class command while giving subcommands, type a 
CTRL/C. 

The BUILD command operates differently from DIRECTORY-class commands 
in putting you automatically into subcommand mode without your typing 
a final comma on the command line, and in offering a special 
subcommand to cancel the command while you are typing subcommands. 

See the individual command descriptions for more detailed information 
about subcommands. 


Other Arguments 

Some command arguments are not introduced by special characters such 
as slashes or double at signs, but still are particular words, or 
"keywords," having a special meaning to the system. Give these on the 
same line as the command itself, leaving at least one space before and 
between arguments. Certain of these (e.g., the LOGICAL-NAMES argument 
to the INFORMATION command) are actually composed of more than one 
word, joined by hyphens so that the system will not interpret them as 
more than one argument. If the complete command will not all fit onto 
one line, simply keep typing: the system automatically begins a new 
line when necessary, but interprets the typing as if it had all 
appeared on one line. Or you may end a command line at any point with 
a hyphen (-) and a carriage return, and continue the command on the 
next line; the hyphen will not be considered part of your input. 

A few command arguments must be accompanied by special symbols to be 
interpreted correctly. Enclose directory names in angle brackets when 
using them with the CONNECT or ACCESS command, for example; logical 
names (for DEFINE), device names (used with ASSIGN), and structures 
and tape sets (used with MOUNT or DISMOUNT) all require a colon at the 
end. (But note that when supplying what look like structure and tape 
set names to the related CANCEL command, you are supplying jobnames, 
and must not include the colon.) If you punctuate a command argument 
incorrectly, the system will usually print a message reminding you of 
this . 
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SPECIAL FEATURES 


Defaults 

The concept of "defaults," or command arguments assumed when you do 
not specify a choice, is important for understanding TOPS-20. To 
speed processing of commands and to help inexperienced users, the 
system uses defaults when necessary for completing commands that you 
give. By taking advantage of this defaulting action, you can make the 
system work faster and more efficiently for you. This manual displays 
prominently the available choices of command arguments and the 
established defaults for these. 

There are different kinds of default. When you give file 
specifications as arguments to, say, the PRINT command, the system 
assumes that you are referring to the highest (most recent) generation 
of these files in your connected structure and connected directory. 
By specifying a different structure, directory, or generation you can 
override this default, but only if you already have the right 
(established by user membership in a group, perhaps, or by a prior 
ACCESS command) to do so. 

When you give the INFORMATION BATCH-REQUESTS command without further 
arguments, you are presented with a listing of all requests in the 
batch input queue. The /USER switch allows you to limit this display 
to the jobs of the user named. If you give the switch without 
supplying a user name, your own user name is used as default. (But 
the /USER switch to the related SUBMIT command has meaning for 
privileged users only, who can use it to run batch jobs under other 
user names; for non-pr ivileged users this switch effectively defaults 
to your own user name.) Only a few command arguments behave like the 
/USER switch. The /TIME switch to the SUBMIT command is worth noting: 
by not giving the switch, you set a time limit of 5 minutes; by 
giving the switch without specifying a time limit, you are setting a 
1-hour limit; and you can set any other time limit by supplying it as 
argument to the switch. 

Note that none of the three switches to INFORMATION BATCH-REQUESTS and 
INFORMATION OUTPUT-REQUESTS (/ALL, /FAST, and /USER) is used as a 
default: each calls for a listing that differs in some respects from 
that yielded by the unmodified command. However, the INFORMATION 
LOGICAL-NAMES command, which allows keywords ALL, JOB, and SYSTEM, has 
JOB as default for these. The list of arguments associated with each 
command makes these choices clear. 

To discover what default argument (if any) is established for a 
switch, subcommand, or other argument, press the ESC key instead of 
giving the argument: the default will be printed on your terminal. 


Recognition 

"Recognition" input is another feature of the TOPS-20 operating system 
that speeds up your input, by finishing the typing of a command or 
command argument for you when you have given only part of it and then 
prompting your next response. 
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As soon as you have typed enough of a command or argument to 
distinguish it from others, press the ESC key: the system will finish 
the word if possible and prompt your next input with guidewords 
enclosed in parentheses. (Note that this manual does not show 
guidewords except in the Format section of each command description.) 
By pressing the ESC key without beginning an argument you make the 
system print the default argument if there is one. If the system 
cannot help you, either because you have not typed enough characters 
to make your intentions clear or because there is no default, your 
terminal makes a warning noise - either a ringing bell or high-pitched 
beep . 

Because the ESC key does not produce a printed character, you may be 
unable to remember exactly where you pressed it when later examining 
the output from a hard-copy terminal. If you want to avoid this 
possibility, use the TERMINAL NO RAISE command to make your terminal 
produce lowercase input, to distinguish it from the uppercase printing 
of the system. 

You cannot use recognition for device names (including file 
structures), jobnames (e.g., with the MODIFY or CANCEL command) or 
logical names. 

Abbreviation 

By abbreviating commands and command arguments, you can further 
increase the speed with which you give instructions to TOPS-20. The 
smallest unigue abbreviation for a command or argument will stand for 
the entire word; if there is a default choice for further arguments, 
the system will assume you want this too. (You can determine 
sufficient abbreviations by using the ESC key: any correctly 

recognized abbreviation will stand for the word.) For example, the 
abbreviated command FD stands for the FDIRECTORY Cconnected directory> 
command; I L stands for INFORMATION (ABOUT) LOGICAL-NAMES (OF) JOB. 

There are a few cases where non-unigue abbreviations will stand for a 
frequently-used command. CON stands for CONTINUE and not for CONNECT. 
Similarly, D abbreviates DEPOSIT, E abbreviates EXAMINE, EX stands for 
EXECUTE, and LOG is understood as LOGIN. 

You cannot use abbreviation (or recognition) in a few cases. The 
names of devices (including file structures), logical names, and 
jobnames (given, for example, as arguments to the MODIFY or CANCEL 
command) must be typed in full; and of course passwords cannot be 
abbreviated or recognized. 


Question Marks 

Whenever you type a question mark (?) instead of (or even in the 
middle of) a TOPS-20 command or command argument, the system responds 
with instructions or a list of possible completions. By using 
question marks and recognition when you are unsure of the proper 
command or argument, you can have the system help you during your 
terminal session. 

These features, together with the, HELP command, which provides 
information on various system programs, are valuable supplements to 
the written documentation for TOPS-20. 
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DATE-TIME ARGUMENTS 

You can specify date and time arguments to many of the TOPS-20 
commands. The following sections describe the formats for these 
arguments . 


Date 

The examples below show the various formats that are acceptable for 
the date argument: 

Jun 30 1981 30 Jun 1981 

May 1, 82 l/May/1982 

January 000005 75 0005-January-000075 

F/13-83 5/17/83 

If the month and day are both numeric, the first number of the two, if 
less than 13, is considered to be the month. Otherwise, the second 
number is considered to be the month. For example: 

2/15/83 is February 15th 

15/2/83 is February 15th 

You can abbreviate the month to as few characters as possible without 
causing it to be confused with another month. Thus, 

O 

Jun 

Jul 

Ja 

are acceptable abbreviations for October, June, July, and January. 

Many commands allow you to give the day of the week or "today" for the 
date . 

If you specify the time along with the date, you must separate the two 
arguments by at least one space and/or no more than one tab. 


Time 

For the time argument you can specify: 

© time according to a 24-hour clock: 

/AFTER:17:00:00 
® AM and PM: 

@ SET ALERT 5:00PM 
o the following time zones: 
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Arguments 

Zone 

Hour Offset 
from Greenwich 

GST, GDT , GMT 

Greenwich 

0 

AST, ADT 

Atlantic 

4 

EST, EDT 

Eastern 

5 

CST , CDT 

Central 

6 

MST, MDT 

Mountain 

7 

PST, PDT 

Pacific 

8 

YST , YDT 

Yukon 

9 

HST , HDT 

Hawaii/Alaska 

10 

BST , BDT 

Bering 

11 

DAYLIGHT 

Daylight time for your zone 


STANDARD 

Standard time for your zone 



Examples 


6 : OOPM-EDT 
6 : 0 OPM-PST 
6 : 0 OPM-GMT 


is 5:00PM EST 
is 9:00PM EST 
is 1:00PM EST 


Note that a hyphen (-) is required before the zone. 


The basic time format is: 


hh :mm : ss 


where : 

hh is hours, must be less than 24, and is optional 

mm is minutes, must be less than 60, and is required 

ss is seconds, must be less than 60, and is optional 

The colon between hours and minutes is optional. 


Examples (based on a 24-hour clock) : 

3 is 00:03:00AM 

125 is 1:25AM 

14:30 is 2:30PM 

25:33 is 00:25:33AM 


Relative Date-Time Arguments 

Many commands accept relative dates and times. You can specify that 
an event is to occur at a certain amount of time from the current 
time, from today, or from a certain day of the week. Likewise, you 
can specify relative times in the past. 

Examples 

@SET ALERT +30 sets an alert for 30 minutes from now 


@DIRECTORY , produces a listing of files that 

@ @BEFORE TODAY were created before today's date 
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ACCESS 


Function 


The ACCESS command obtains ownership rights to a directory and 
the group rights of its user-group list. 

Format 

0ACCESS (TO DIRECTORY) dev : <directory> 

Password : password 

6 

where 

dev : <directory> is the directory that you want to access 

Default dev: - your connected structure 

Default <directory> - the directory (on 

the specified 

structure) of the 
same name as your 
connected 
directory 

password is the password of the directory (not 

requested for your log-in directory or a 
directory of the same name as your log-in 
directory on a domestic structure) 

Characteristics 


Capabilities 

Your capabilities (such as Wheel, Operator, Confidential) 
are associated with your log-in user name only. If you give 
the ACCESS command for a directory whose owner has Wheel 
capabilities, say, you do not gain these capabilities. 

Restrictions 


One Directory Per Structure 

You can access only one directory at a time on each mounted 
structure. Each ACCESS command ends any previous ACCESS 
command (including the implicit access obtained by the LOGIN 
command) for that structure. If you access another 
directory on the public structure you give up your own group 
rights on the public structure. These are restored when you 
give an ACCESS command for your log-in directory. 
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Not For Files-only Directories 

Because a files-only directory does not have an owner or 
user group rights, you cannot give an ACCESS command for it. 
Use CONNECT instead. 


Effect on Memory and Terminal 


The ACCESS command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


CONNECT for making a directory your connected 

directory 

END-ACCESS for surrendering rights to an accessed 

directory 

MOUNT STRUCTURE for making a structure available for access, 

and ensuring the continued availability of an 
accessed structure 


Examples 


1. Access another user's directory. 

B ACCE5S (HOLLAND)- 

PASSWORD : 

@ 

2. Access another user's directory so you can copy a file from 
it to your connected directory. 

B ACCESS < HOLLAND> 

PASSWORD: 

B COPY < HOLLAND >MAX, MEM HOLMAX.MEM 
< HOLLAND > MAX. MEM. 1 = > HOLM AX . MEM . 1 [OK] 

B END-ACCESS < HOLLAND)' 

B 

3. Access the log-in directory of a user whose group rights you 
want to borrow. 

B COPY < MANUALS >REL3A . MEM REL3A . MEM 
7DIRECT0RY ACCESS PRIVILEGES REQUIRED 
B ACCESS < HOLLAND > 

PASSWORD : 

B COPY < M A N J A L S > R E L 3 A . MEM REL3A . MEM 
< MANUALS >REL3A . MEM . A = > REL3A . MEM ,1 [OK] 

B END-ACCESS (HOLLAND) 

B 
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4. Access the directory of a user on another structure, 
examine his directory and copy a file from it. 

6 M0UNT STRUCTURE SNARK : 

STRUCTURE SNARK : MOUNTED 
i ACCESS SNARK : (HOLLAND) 

PASSWORD : 

SD I RECTORY 5N ARK ;< HOLLAND > 


SNARK :<H0LLAND> 

ACCT.MEM. 1 
ACTGEN. . 1 
COMP. FOR. 1 
COMPUT.CBL. 1 
, REL , 1 

DIFFER. FOR. 1 
.QOR. 1 
MAIL.TXT ,2 
OVERVIEW . MEM . i 

TOTAL OF 9 FILES 
B COPY SNARK : < HOLLAND >COMP . FOR 
SNARK: < HOLLAND > COMP. FOR. 1 => COMP. FOR. 1 [OK] 
B END- ACCESS SNARK :< HOLLAND > 

B DISMOUNT STRUCTURE SNARK: 

STRUCTURE SNARK: DISMOUNTED 
S 


Then 



ADVISE 


Function 


The ADVISE command links your terminal with another user's 
terminal so that you can give commands to his job. The advisee 
can still give commands to his job. 


Format 


@ ADVISE argument 
where 

argument is either a user name or terminal line 

number . 


Characteristics 


Input to Other Job 

For as long as the ADVISE command is in effect, the commands 
you give affect the advisee's job instead of your own. 

Ending Advice 

To end an advising link that you have formed between 
terminals, you must type CTRL/E. This CTRL/E is not echoed 
on either terminal. 

Refused Advice 

Ordinarily, you cannot advise a job unless its terminal is 
set to receive advice. However, if you have Wheel or 
Operator capabilities enabled, you can advise any job. 


Hints 


Help During ADVISE 

Once you are advising another job, you can type CTRL/"? for 
a short list of special commands that can now be used to 
send comments or control characters, or to relink to a 
terminal that has broken links with yours. (Note: giving 
the BREAK command does not end advice but merely prevents 
the advisor's terminal from printing what either user 
types . ) 


4 



ADVISE (Cont.) 


Special Cases 


Advisee Has More Than One Job 

If more than one job is logged in under the user name you 
specify, the system gives you a list of that user's terminal 
numbers and associated programs to choose from, then prints 
TTY: to prompt your response. Type your choice of terminal 

number after the prompt. 

Advising a Pseudoterminal (PTY:) 

If you try to advise a PTY: the system informs you of this 
and asks you to confirm with a carriage return. 


Restr ictions 


Compatible Terminals 

Unless the terminals involved in an advising link have 
compatible characteristics (e.g., terminal width, ability to 
handle tabs and lowercase letters) , some information can be 
lost or overprinted. To avoid this problem, the user of the 
faster or more capable terminal should adjust his terminal's 
characteristics, if possible before the ADVISE command is 
given . 

Detached Jobs 

You cannot advise detached jobs. 


Warning 


Talking Between a VT100 and a VT52 

If links between VT100 and VT52 terminals are established 
using an ADVISE (or TALK) command, the VT52 may function 
improperly during or after the linked interval (e.g., by 
requiring frequent CTRL/Q commands to print multiple lines 
of output) . Turning the terminal off and then on again 
(after the linked interval) will correct this problem. 
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ADVISE (Cont.) 


Effect on Memory and Terminal 


The ADVISE command does not affect memory and leaves your 
terminal at the advisee's terminal's command level, controlling 
his job. 


Related Commands 


RECEIVE ADVICE 
REFUSE ADVICE 
REMARK 
TALK 


Examples 


1. Advise a user, then immediately type CTRL/E to end advice. 
E ADVISE D, CROWLEY 

ESCAPE CHARACTER IS < CTRL >E t TYPE <CTRL>? FDR HELP 
D. CROWLEY JOS 51 EXEC 

LINK FROM LATTA , TTY 22G 
[ADVISING] 

SB [ADVICE TERMINATED] 

@ 


2. Advise a user's job and access a directory for him. 
E ADVISE BONSAVAGE 

ESCAPE CHARACTER IS < CTRL >E > TYPE <CTRL>? FOR HELP 
BONSAVAGE JOB 48 EXEC 

LINK FROM LATTA » TTY 22G 
[ADVISING] 

! I 'LL ACCESS THE DIRECTORY FOR YOU > THEN YOU CAN US E I T . 
@ ACCESS < 5 ART INI > " 

P a s s w o r d : 

E ! □ K A Y > NOW YOU CAN USE IT, 

E ! T h a n K v o u . 

[ADVICE TERMINATED] 

@ 


for allowing other users to advise you 

for preventing other users from advising you 

for sending comments only 

for linking terminals so that your commands 
affect only your own job 
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3. Advise another user, demonstrating how to use the FILCOM 
program . 

@ ft D MI S E D , CROWLEY 

ESCAPE CHARACTER IS < CTRL >E » TYPE <CTRL>? FOR HELP 
D , CROWLEY JOB 51 EXEC 

LINK FROM LATTA , TTY 226 
[ADVISING] 

! HERE 'S HOW T O COMPARE FILES USING THE FILCOM PROGRAM. 

@F I LOOM ' 


*=VERCBL.TXT , BAKVER.TX T / A 


No differences encountered 
* C 

@ ! SEE? THE SWITCH AT THE END (/A) MEANS TO COMPARE THEM IN 
B iASCII MODE. DON'T FORGET THE CTRL/C WHEN YOU'RE DONE, 

@ ! THANKS. ' 

@ 

[ADVICE TERMINATED] 

@ 


4. Advise a user who is logged in at more than one terminal. 
Choose one of them. 

B ADVISE LATTA 
TTY25 , EXEC 
TTYA1 , EXEC 
TTY27 , EXEC 
TTY: 27 

Escape character is < CTRL >E > type < CTRL >? for help 
LATTA Job 22 EXEC 

LINK FROM D , CROWLEY . TTY 225 
[ A d u i s i n 3 ] 

* * * 

[ A d v i c e terminated] 

@ 
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APPEND 


Function 


The APPEND command adds the contents of one 
to the end of a new or existing destination 
the original source files unchanged. 


or more source files 
file on disk, leaving 


Format 


@APPEND (SOURCE FILE) source filespec(s) (TO) destination filespec, 
@@subcommand 

where 


source filespec(s) 
destination filespec 
@@subcommand 


is a single file specification, or a 
series of them separated by commas 

is the specification of the destination 
file on disk; this can be a new file. 

means that after a final comma you can 
type an optional keyword, modifying the 
mode or format of information transfer, 
as described below 


APPEND Command Subcommands 
(when used with the paper tape reader - PTR:) 

PARITY 

ASCII NOPARIT'Y specifies that the files being appended 

are written in ASCII mode, with 36-bit 
words each consisting of five 7-bit 
bytes and a parity bit; the PARITY 
argument is not currently in use; 
NOPARITY (the default) means that the 
eighth hole of the paper tape is never 
punched . 

BINARY specifies that the files being appended 

are composed of 36-bit words, each 
consisting of six 6-bit bytes, with the 
seventh hole of the paper tape set 
always to 0 and the eighth hole set 
always to 1; causes a checksum 
calculation . 

BYTE n specifies that the byte size of the 

destination file is to be n (any decimal 
number). If you do not give the BYTE 
subcommand, the destination file will 
have the same byte size as the source 
f ile . 
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IMAGE specifies that the files being appended 

are composed of 36-bit words, each 
consisting of one 8-bit byte; the 28 
most significant bits are lost on 
output . 

IMAGE BINARY same as BINARY, but lacking the checksum 


APPEND Command Subcommands 

(when used with devices other than the paper tape reader) 


( PARITY 

ASCII I NOPARITY 


BINARY 

BYTE n 


IMAGE 

IMAGE BINARY 


specifies that the files being appended 
are written in ASCII mode, with 36-bit 
words each consisting of five 7-bit 
bytes and a parity bit; the PARITY 
argument is not currently in use; 
NOPARITY (the default) means that the 
least significant bit is set to 0 on 
input and is lost on output. 

calls for a direct transfer of data in 
36-bit bytes 

specifies that the byte size of the 
destination file is to be n (any decimal 
number). If you do not give the BYTE 
subcommand, the destination file will 
have the same byte size as the source 
f ile . 

same as BINARY 
same as BINARY 


Output 


As each file is appended, the system prints its specification and 
the word [OK]. Also, if recognition is used on the destination 
file specification, the system prints its status (Old generation, 
New generation. New file, or Superseding, for disk files; or OK, 
if the files are appended to a non-disk device) . 


Characteristics 


Files Appended in Order Specified 

The APPEND command attaches source files to the destination 
file in the order you specify them; the contents of the 
last specified source will appear at the end of the 
destination file when APPEND is finished. 
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Subcommands Optional 

For most purposes you do not need to use subcommands when 
transferring information with the APPEND command. These 
subcommands, specifying the format of the appended files, 
are required only when using certain devices (for example, 
devices of the form MTn : (tape drives) using labeled tapes, 
or PTR : (paper tape reader) ) or under particular conditions 
(for example, when transferring files over network 
facilities). If you are appending information from disk 
files or from your terminal and you do not use any 
subcommands, the data will be appended as written, whether 
in a standard format (usually ASCII or binary) or not. 


Special Cases 


Wildcard Characters 

Wildcard characters (* and %) can be used in source file 
specifications only. The files are then appended in 
alphabetical order. 

Appending Information from your Terminal 

If you type TTY: in place of source file specifications, 
the system appends any characters you then type (after 
completing the command itself) , until you give a CTRL/Z to 
return your terminal to TOPS-20 command level. CTRL/U, 
CTRL/R, CTRL/W, and the Delete key can be used to edit the 
current line of terminal input. 


Restrictions 


Source Files With Differing Formats 

You can use the APPEND command to transfer data from a 
magnetic tape, terminal, card reader, paper tape reader, or 
other device to disk files. but if source files written in 
differing formats are specificied within the same command, 
some data can be lost in the transfer. 

Mixing Sequenced and Unsequenced Files 

Source files created by the EDIT program should not contain 
sequence numbers when they are appended. Mixing files that 
contain sequence numbers with files that do not will cause 
EDIT to function improperly if used on the resulting file. 


10 


April 1982 



APPEND (Cont.) 


Appending to Archived Files 

You can append the contents of an archived file to another 
file, by specifying it as the first (or source) argument of 
an APPEND command. You can then edit the resulting file, 
because it does not gain archive status although part of its 
contents are the same as those of the archived file; the 
archived file remains unchanged. However, you cannot give 
the specification of an archived file as the second (or 
destination) argument of an APPEND command, as this would 
change the file's contents. 


Effect on Memory and Terminal 


The APPEND command does not affect memory, and leaves your 
terminal at TOPS-20 command level. 


Related Commands 

COPY for making copies of files 


Examples 


1. Use the APPEND command to join two files. 

B APPEND FORT. FOR FIL.FOR 
FORT. FOR. 8 [OK] 

B 

2. Append two files to the end of a third file. 

B APPEND FORT. FOR . GORT.FQR GIL. FOR 
FORT. FOR. 8 COK] 

GORT . FOR . 6 [OK] 

B 

3. Access a directory and append a file from it to a file in 
your connected directory. 

B ACCESS < M A N U A L S > 

P a s s w o r d : 

B APPEND < M A N U A L S > R E L 3 A . M E M REL3A.MEM 
< MANUALS >REL3A.MEM. 4 [OK] 

B END-ACCESS < MANUALS > 

B 
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4. Use a wildcard character (%) to append several files to the 
end of another file. 

B APPEND 7. □ R T . FOR HIL.FOR 
FORT. FOR. 8 COK] 

GORT . FOR . G [OK] 

HORT . FOR , 3 [OK] 

MORT . FOR . 2 [OK] 

B 

5. Use a wildcard character with the APPEND command to create a 
new file. 

B APPEND * . T X T BACKUP, TXT 
MAIL. TXT , 1 [OK] 

NEWRUN.TXT . 1 [OK] 

NX. TXT. 1 [OK] 

B 

6. Append a message from your terminal to the beginning of the 
file created in Example 5. Use the symbolic generation 
number -1 to specify this action. 

B APPEND TTY: .BACKUP. TXT B ACK UP , TXT . - 1 
TTY: 

! TH I S IS A BACKUP FILE FOR ALL TEXT FILES. 

••• T " 
l— 

BACKUP . TXT . 1 [OK] 

B 
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ARCHIVE 


Function 


The ARCHIVE command asks that a permanent off-line copy of 
specified files be made on magnetic tape, and prevents the disk 
copy (if retained) from being modified. 


Format 


0ARCHIVE (FILES) f ilespec , . . . , 
@@subcommand 


where 


filespec is the specification of a file of which 

you want a permanent copy 

means that, after commas, you can give 

more arguments of the form already shown 


@@subcommand means that after a final comma you can 

type an optional subcommand. The 

following subcommand is available: 


RETAIN which causes the disk copies 

of the files being archived to 
be retained in your directory, 
rather than deleted and 
expunged 


Output 


Whenever a file is taken off line as a result of your ARCHIVE 
command (i.e., when you do not also give the RETAIN subcommand), 
the operator sends a MAIL message notifying the owner of the 
directory from which the file was taken. For this purpose, the 
owner of the directory is defined to be the user or users whose 
user names appear in a file of specification DIRECTORY . OWNER in 
the directory. If this file does not exist, the message is sent 
to MAIL . TXT in the directory. If neither file exists, no message 
is sent. 
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Characteristics 


Archived Files Unalterable 

You cannot change the contents of files specified in an 
ARCHIVE command once the command is given, even if the files 
are not immediately copied to tape. This means that you 
cannot alter or add to them by using the EDIT or APPEND 
command, or overwrite them by using the COPY or RENAME 
command. In general, files for which you have requested 
archival must not be given as the second filespec argument 
of these commands. 

Archived Files Invisible 

The files you specify in an ARCHIVE command ordinarily 
become invisible to most TOPS-20 commands as soon as the 
ARCHIVE command is given. However, if you include the 
RETAIN subcommand when giving the ARCHIVE command, the files 
remain visible. See Related Commands, below, for a list of 
commands you can use with invisible files. 


Effect on Memory and Terminal 


The ARCHIVE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


CANCEL ARCHIVE for canceling archival 

requests 

DELETE (with ARCHIVE subcommand) 

for deleting archived files 

(with CONTENTS-ONLY subcommand) 

for deleting only the disk 
copy of files that also have a 
tape copy 

DIRECTORY (with ARCHIVE subcommand) 

for requesting information on 
archived files (visible and 
invisible) only 

DIRECTORY (with INVISIBLE subcommand) 

for requesting information on 
invisible files only 
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DISCARD for giving up the tape copy of 

on-line files 

INFORMATION ARCHIVE-STATUS 

for determining if archival 
for the specified files 
(visible and invisible) has 
been accomplished 

RETRIEVE for restoring off-line files 

(visible and invisible) to 
on-line status 

SET FILE INVISIBLE for making visible files 

invisible 

SET FILE VISIBLE for making invisible files 

visible 


Examples 


1. Archive a file. 

B A R C H I U E ARTEST . F I L 
ARTEST.FIL.i [Requested] 

5 

2. Archive a file, but keep a copy on disk. Check the archive 
status of files. 

6 ARCHIUE ARCHEK .FIL > 

6B RETAIN 

BB 

ARCHEK. F I L.i [Requested] 

6 I NFQRMAT I ON ARCH I UE-STATUS 

ARCHEK. FIL. 1 Archiue requested. Retain contents 
ARTEST.FIL.i Archiue requested 
B 
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3. Attempt to edit an archived file (first you must make it 
visible). Note that, afterwards, the unedited backup copy is 
the archived file, and that the edited file has no archive 
status . 

@ I NFORMAT I ON ARCH I VE- STATUS ARTEST , F I L 
ARTEST .FIL. 1 Archive requested 
B EDIT ARTEST , FIL 

"L N o such filename* Creating New file 
Input : ARTEST, FIL. 2 
0 0 1 0 0 $ 

* Eg ~ 

B SET FILE VISIBLE ARTEST, FIL 
ARTEST. FIL. 1 [OKI 
B ED I T ARTEST .FIL 
Edit: ARTEST . FIL . 1 
*P 

00100 ! TEST FILE FOR ARCHIVING 

* I 2 0 0 

0 0 2 0 0 ! FIRST MODIFICATION 

00300 $ 

* P - : * 

00100 ! TEST FILE FOR ARCHIVING 

00200 ! FIRST MODIFICATION 

*EL) 

[ARTEST. FIL. 21 

B I NFORMAT I ON ARCH I VE - ST ATUS ARTEST,* 

ARTEST. OIL. 1 Archive requested 
6 TYPE ARTEST .OIL 

! test file for archiving 

B TYPE ARTEST. FIL 
! TEST FILE FOR ARCHIVING 
! FIRST MODIFICATION 
B DIRECTQRY ARTEST . * 

M ISC : < LATTA > 

ARTEST. FIL. 2 
.OIL. 1 

Total of 2 files 
B 
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ASSIGN 


Function 


The ASSIGN command reserves a specific input-output device for 
your job. 


Format 


@ ASSIGN (DEVICE) dev: 
where 

dev: is the name of the device you want to assign 

Restrictions 

Assigning Magnetic Tape Drives 

You can use the ASSIGN command to assign tape drives only if 
they are of the form MTAn : . Tape device names of the form 
MTn : are logical device names only, and are assigned 

automatically at the time of MOUNT TAPE commands. 


Effect on Memory and Terminal 


The ASSIGN command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


DEASSIGN 

MOUNT 

INFORMATION AVAILABLE DEVICES 


for surrendering a previously 
assigned device 

for mounting a structure or 
magnetic tape set without 
assigning a specific drive 

for finding out which devices 
can be assigned or have been 
assigned to your job 
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Examples 


1. Assign a tape drive to your job. 

B ASSIGN MTAO : 

@ 

2. Find out which devices are available for timesharing 
then assign one to your job. 

6 I NFORMAT I ON AVAILABLE DEVICES 
Devices available to this Job: 

DSK , PS t SNARK t MISC » LANG , MT A 1 , LPT » LPTO , LPT1 
CDR i PCDRO » CDPt FE1-15 > PTY20-G1* NULt PLTt PLTO 
DCN » SRU 

Devices assigned to/opened by this Job: T T Y 1 
B ASSIGN PCDRO: 

B 


use , 
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ATTACH 


Function 


The ATTACH command engages a job to your terminal. 


Format 


@ ATTACH (USER) name (JOB #) number 

PASSWORD: password 

where 

name is the user name of the job's owner 

number is the job number 

Default the only job, or only 
detached job, or only job 

other than your current 
job, logged in under the 

user name you give 

password is the associated password (not 

requested if you are currently logged in 
under the same user name as the job that 
you are attaching) 


Characteristics 


Current Job Detached 

If you give the ATTACH command while logged in, your current 
job is detached. You can use the LOGOUT n command to log 
out this detached job. 


Hint 


Using ATTACH to Restore Phoned-in Jobs 


If you log in to the system by telephone lines and service 
is interrupted for any reason, use the ATTACH command to 
restore the connection. If you do not do this within five 
minutes, your job will be logged out automatically and you 
will have to log in again. 
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Warning 


Attaching Attached Jobs 

The system will ask you to confirm your choice with a 
carriage return before attaching to your terminal a job that 
is attached elsewhere. If you attach an attached job that 
is running a program, that program may be sent one or more 
CTRL/Cs, which can affect programs that handle CTRL/C 
themselves. To avoid this possibility you must give a 
DETACH command from the terminal to which the program's job 
is attached, then attach this job to your terminal with an 
ATTACH command . 


Effect on Memory, Terminal, and Job 


The ATTACH command affects neither memory nor the job that you 
are attaching (but see Warning, above) , and leaves your terminal 
at TOPS-20 command level unless a program is being run by the 
job. If a program is being run, your terminal is left at command 
level, if any, in the job. Your terminal's characteristics will 
be those established in the job from which you gave the ATTACH 
command; if you were not logged in, they will be reset to system 
default characteristics. 


Related Commands 


SYSTAT for finding out the user name and job number 

associated with any job 

DETACH for disengaging a job from your own terminal 

UNATTACH for disengaging a job from any other terminal 


Examples 


1. Attach your only job, which is presently detached. 

@ ATT ACH LATTA 

PASSWORD : 

@ 

2. Attach one of several detached jobs. 

@ ATT ACH LATTA 

? JOB # REQUIRED - LATTA HAS MORE THAN ONE DETACHED JOB 
B SYSTAT LATTA 

37 DET EXEC LATTA 

BA DET NRRY LATTA 

@ ATT ACH LATTA 37 

PASSWORD: 

@ 
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3. Check your jobs (your current job is marked with an 
(*)), then attach the only detached job. Verify the 
action . 

@ 5 Y 5 T ft T L ATT ft 


37 

2E 

NEWRUN 

LATTA 

58 

DET 

EXEC 

LATTA 

59* 

231 

EXEC 

LATTA 


6 ATTACH LftTTfl 
DETACHING JOB # 59 
B INFORMATION JOB 

JOB 58 t USER LATTA , ACCOUNT LANGUAGE » TTY231 

6 

4. Start a program in one job. Then detach and continu 
attach another of your jobs. 

@ INFORMATION JOB 

JOB 9 , USER LATTA i ACCOUNT LANGUAGE > TTY2B 
@ RUN FFACTOR 

j_C 

B DETACH CONTINUE 
DETACHING JOB # 9 
j_C 

SYSTEM 2102 DEVELOPMENT SYSTEM » T0PS-20 MONITOR A (321 
6 SYSTAT LATTA 

9 DET FFACTO LATTA 

45 41 EXEC LATTA 

B ATTACH LATTA 45 
[ATTACHED TO TTY41 , CONFIRM] 

PASSWORD: 

S 


aster isk 
system ' s 


it, and 


) 
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BACKSPACE 


Function 


The BACKSPACE command moves a magnetic tape set backward over a 
specified number of files or records. 


Format 


^BACKSPACE (DEVICE) dev: n units 
where 

dev: is the name of the tape set or magnetic tape drive that 

you want to move backward 

n is the number of files or records over which you want 

to backspace 

Default n - 1 

units is either FILES or RECORDS 

Default units - FILES 


Restrictions 


BACKSPACE with Open Files 

If you have given a CTRL/C to exit from a program that has 
opened a magnetic tape drive and you then give the BACKSPACE 
command for that tape drive, the system will first ask if 
you want to close the associated file. You must do so for 
BACKSPACE to succeed, but you will probably be unable to 
continue the program from that point because the file will 
now be closed. 

RECORDS Argument Used for Unlabeled Tapes Only 

You cannot give the RECORDS argument to the BACKSPACE 
command when using a labeled tape, because read and write 
operations for labeled tapes always move the tape to the 
beginning of a file first. 


Effect on Memory and Terminal 


The BACKSPACE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 
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Related Commands 

SKIP for moving a magnetic tape set forward 

REWIND for backspacing a tape volume or tape set to its 

logical beginning (the beginning of the first file) 

Examples 


1. Backspace your magnetic tape one file. 

B BACK5PACE MTO; 1 FILE 
i 
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BLANK 


Function 


The BLANK command clears your video terminal screen. It has no 
effect on a hard copy terminal. 


Format 


0BLANK (SCREEN) 

0 


Characteristics 


This command moves the cursor to line 1 of the screen, providing 
you with a clean area for typing commands and receiving system 
output . 


Effect on Memory and Terminal 


The BLANK command does not affect memory and leaves your terminal 
at T'OPS-20 command level. 
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BREAK 


Function 


The BREAK command ends communication links that have been formed 
between your terminal and those of other users. 


Forma t 


@BREAK (LINKS WITH) argument 

@ 

where 

argument is a user name or line number. If you do not 

specify an argument, all communication links are 
broken . 


Restrictions 


Does Not End Advice 


The BREAK command, given at either of 
by the ADVISE command, does not 
prevents the advisor's terminal from 
user types. Only a CTRL/E typed at 
ends advice. 


two terminals joined 
end advice but merely 
printing what either 
the advisor's terminal 


Effect on Memory 


The BREAK command does not affect memory and leaves your terminal 
at TOPS-20 command level. 


Related Commands 


TALK 

for establishing 
another terminal 

communication 

links 

with 

REFUSE LINKS 

for preventing future communication 
your terminal 

links 

with 


Examples 


1 . 


Use the BREAK command to end 
user . 


a TALK session with 


another 


0BREAK 

i 
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2. Use the TALK command to speak to another user, then use BREAK 
to end the conversation. 

@ T ALK PQRADft 

LINK FROM LATTA , TTY IX 1 

@ ! HI . CAN YOU TELL ME WHERE THE PROJECT ESTIMATES ARE STORED? 

@ ! SURE : THEY'RE ON TAPE LS2.0 IN THE LIBRARY, 

@ ! THANKS , BYE 

B BREAK 

@ 
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BUILD 


Function 


The BUILD command creates, modifies, or deletes a directory 
subordinate to a directory to which you have write access. 


Format 


0BUILD (DIRECTORY NAME) str : <directory> 
@@subcommand 

@@ . 

@@ 

e 


where 


str : 

is the name of the (mounted) structure 
containing the directory you are 
building . 

directory 

is the name of the directory you are 
building; it must be of 39 or fewer 
characters . 

@@ . 

indicates that you automatically enter 

# 

subcommand mode after completing the 

@@ 

BUILD command line 

subcommand 

is a keyword, chosen from the list 
below, indicating your choice of BUILD 
command options 


Summary of BUILD Command Subcommands (defaults in boldface) 
ABORT 

ABSOLUTE-ARPANET-SOCKETS 
ACCOUNT-DEFAULT account 
ARC HIVE-ON LINE-EXP I RED- FILES 
ARPANET-ACCESS 
ARPANET-WIZARD 
CONFIDENTIAL 
DECNET-ACCESS 

DEFAULT-FILE-PROTECTION octal protection code 

DIRECTORY-GROUP group number n 
DISABLE 
ENABLE 
ENQ-DEQ 
FILES-ONLY 
GENERATIONS n 
IPCF 
KILL 


Default code - 
777700 


Default n - 1 
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& NAME-ONLY 
LIST S FAST 

l VERBOSE 
MAINTENANCE 

MAXIMUM-SUBDIRECTORIES n 

/ ABSOLUTE-ARPANET-SOCKETS 
I ARCHIVE-ONLINE-EXPIRED-FILES 


ARPANET-ACCESS 

ARPANET-WIZARD 

CONFIDENTIAL 

DECNET-ACCESS 


NOT < 




DIRECTORY-GROUP group number n 

ENQ-DEQ 

FILES-ONLY 

IPCF 

KILL 

MAINTENANCE 

OPERATOR 

REPEAT-LOGIN-MESSAGES 
SUBDIRECTORY-USER-GROUP group number 
USER-GROUP group number n 

WHEEL 


n 


NUMBER octal directory number 
OFFLINE-EXPIRATION-DEFAULT date or +n 
ONLINE-EXPIRATION-DEFAULT date or +n 
OPERATOR 

PASSWORD 1- to 39-character word 

PERMANENT n 

PROTECTION octal protection code 


PUSH 

REPEAT-LOGIN-MESSAGES 

SUBDIRECTORY-USER-GROUP group number n 
USER-GROUP group number n 


WHEEL 
WORKING n 


Default n - 0 


Default n - 90 
Default n - 60 


Default n - 250 
Default code - 
777700 


Default n - 250 


BUILD Command Subcommands 


ABORT 


cancels all work done during current 
BUILD command. If directory was new, it 
does not exist; if old, it remains 
unchanged . 


ABSOLUTE-ARPANET-SOCKETS 

allows the directory owner to establish 
ARPANET network connections using 32-bit 
absolute socket numbers; users with 
Wheel or Operator capabilities can also 
perform this function. For use only 
with systems that are members of the 
ARPA network. See the TQPS-20AN User's 
Guide for more information. 
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BUILD Command Subcommands (Cont.) 


ACCOUNT-DEFAULT' account 

causes the specified account to be 
charged for a terminal session whenever 
the user does not include an account in 
his LOGIN command. 

ARCHIVE-ONLINE-EXPIRED-FILES 

causes on-line files that have expired 
to be marked for archiving. 

allows the directory owner to establish 
ARPANET network connections. This 
subcommand works in conjunction with 
pre-established system manager controls. 

allows the directory owner to use 
special queues for sending and receiving 
information on the ARPANET network. For 
use only with systems that are members 
of the ARPA network. See the TQPS-20AN 
User 1 s Guide for more information. 

CONFIDENTIAL 

grants the directory owner confidential 
information access capabilities, 
allowing him to obtain confidential 
information within the system via 
certain monitor calls. See the TQPS-20 
Monitor Calls Reference Manual for 
details . 

DECNET'-ACCESS allows the directory owner to establish 

DECNET network connections. This 
subcommand works in conjunction with 
pre-established system manager controls. 

DEFAULT-FILE-PROTECTION octal protection code 

assigns this number as default for the 
protection code of each file 
subsequently placed in the directory. 
The protection code is constructed (by 
addition) from the octal values shown 
below: 

77 full access to the file 
40 read the file 
20 write and delete the file 
10 execute the program contained in 
the file 

04 append to the file 

02 list the file specification using 
DIRECTORY-class commands 
00 no access to the file 
Default code - 777700 

See the TQPS-20 User's Guide for more 
information about protection codes. 


ARPANET-ACCESS 


ARPANET-WIZARD 
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BUILD Command Subcommands (Cont.) 


DIRECTORY-GROUP group number n 

places the directory in a group, thereby 
allowing users in the same group access 
to it according to the middle two digits 
of the protection code, and access to 
files in the directory according to the 
middle two digits of each file's 
protection code. You can assign up to 
19 directory goup numbers to each 
directory, with values ranging from 1 
through 262143 (2**18 - 1). See the 
TQPS-20 System Manager's Guide for a 
discussion of groups. 

DISABLE suspends any special capabilities that 

you may have activated with the ENABLE 
subcommand or the ENABLE TOPS-20 
command . 


ENABLE 


ENQ-DEQ 


FILES-ONLY 


GENERATIONS n 


IPCF 


KILL 


allows you to activate any privileged 
capabilities that the system manager has 
given you and that you may need during 
the BUILD session. 

grants the directory owner the ability 
to perform global Enqueue and Dequeue 
functions; these are discussed in the 
TOPS-20 Monitor Calls Reference Manual. 


declares the directory to be a 
files-only directory, i.e., one not 
associated with a user. See 
Restrictions - Files-only Directories, 
below. 

specifies a default for the number of 
successive generations of files to be 
retained in the directory. This number 
must be from 0 to 15, with 0 meaning an 
infinite number. 

Default n - 1 

allows the directory owner to execute 
all privileged IPCF functions; these 
are discussed in the TOPS-20 Monitor 
Calls Reference Manual. 


eliminates the directory and any files 
it contains from the system; you must 
confirm this subcommand with an extra 
carriage return. 
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BUILD Commands Subcommands (Cont.) 


t NAME-ONLY 
LIST < FAST 

( VERBOSE 


MAINTENANCE 


provides a listing at your terminal of 
parameter values set for the directory 
by TOPS-20 commands, BUILD subcommands, 
or by default. The FAST listing always 
includes the subdirectory's name, some 
mention of the password, working and 
permanent storage limits, and, if they 
have been set, directory number, account 


default, maximum number of 
subdirectories allowed to this 
directory, the date and time of last 
log-in, group memberships, and user 
group numbers assignable by this 


directory. The VERBOSE listing adds the 
other values that can be assigned by 
BUILD subcommands, while NAME-ONLY 
restricts output to the directory name. 
Default - FAST 

allows the directory owner to execute 
certain system maintenance functions or 
monitor calls? discussed in the TOPS-20 
Monitor Calls Reference Manual. 


MAXIMUM-SUBDIRECTORIES n 


allows the owner of this directory to 
build up to n subdirectories of his own, 
and subtracts an equal number from the 
value of this parameter for the superior 
directory 


NOT 


” ABSOLUTE-ARPANET-SOCKETS 
ARCHIVE-ONLINE-EXPIRED-FILES 
ARPANET-ACCESS 
ARPANET-WIZARD 
CONFIDENTIAL 
DECNET-ACCESS 

DIRECTORY-GROUP group number n 
ENQ-DEQ 
- FILES-ONLY 

I PC F withdraws the 

KILL 

MAINTENANCE 

OPERATOR 


specified subcommand 


REPEAT-LOGIN-MESSAGES 

SUBDIRECTORY-USER-GROUP group number n 

USER-GROUP group number n 

WHEEL 
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BUILD Command Subcommands (Cont.) 


NUMBER octal directory number 

assigns a specific directory number to a 
new directory (note: usually the 

default is adequate) . Directory numbers 
1 through 17 must never be assigned by 
users, as they are reserved for system 
use . 

Default directory number - assigned 
by system 

OFFLINE-EXPIRATION-DEFAULT date or +n 

establishes the tape expiration date for 
files that are to go off line because of 
migration or archiving. If you specify 
"+n", the expiration date will be n days 
from the date the files are moved off 
line . 

ONLINE-EXPIRATION-DEFAULT date or +n 

establishes the disk expiration date for 
files that are to be created in the 
directory. If you specify "+n", the 
expiration date will be n days from the 
creation date. 

OPERATOR grants Operator capabilities to the 

owner of the directory; these are 
discussed further in the T0PS-2Q 
Operator's Guide . 

PASSWORD 1- to 39-character word 

assigns a password, consisting of 
alphanumeric characters and possibly 
including hyphens (-) , to the directory 

PERMANENT n allocates permanent disk storage 

capacity n (in pages) to the directory, 
and subtracts an equal number from the 
permanent disk storage capacity of the 
superior directory 

Default n - 250 

PROTECTION octal protection code 

assigns the given directory protection 
code to the directory. The protection 
code is constructed (by addition) from 
the octal values shown below: 

77 full access to the directory 
40 access to files in the directory 
(including expunging individual 
files), consistent with the file 
protection of the files 
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BUILD Command Subcommands (Cont.) 


10 connect to the directory without 

giving a password, undelete files, 
expunge the entire directory, and 
change times, dates, and accounting 
information for files. All other 
access is governed by the file 
protection of each file. 

04 create files in the directory 
00 no access to the directory 

Default code - 777700 

See the TQPS-20 User's Guide for more 
information about protection codes. 

PUSH creates a level of TOP5-20 inferior to 

the one from which you issued the BUILD 
command and leaves your terminal at this 
new level. You can then issue TOPS-20 
commands to create conditions or obtain 
information that you may need during the 
BUILD session. Give the POP command to 
return to BUILD. See Example 6. 

REPEAT-LOGIN-MESSAGES causes all system messages (mail sent by 

privileged users to all users, contained 
in the file, PS : <SYSTEM>MAIL.TXT) to be 
printed on the user's terminal each time 
he logs in to this directory. If this 
subcommand is not given, only those 
system messages created since the last 
time he logged in are printed. 

SUBDIRECTORY-USER-GROUP group number n 

allows propagation of any or all of the 
group numbers in a directory's user 
group list to the subdirectories of that 
directory. Issuing this subcommand is 
the first step required in establishing 
subdirectory group rights. You complete 
the process by issuing the USER-GROUP 
subcommand for each subdirectory. You 
can assign up to 19 subdirectory user 
group numbers to each directory, with 
values ranging from 1 to 262143 
(2**18 - 1) . 


USER-GROUP group number n 

assigns the directory owner to the given 
user group. You can assign up to 19 
subdirectory user group numbers to each 
directory, with values ranging from 1 to 
262143 (2**18 - 1) . See the TOPS-20 
System Manager's Guide for a discussion 
of groups. 
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BUILD Command Subcommands (Cont.) 


WHEEL 


WORKING n 


grants Wheel capabilities to the owner 
of the directory, allowing him to 
perform all the privileged functions 
available on the system; these are 
discussed further in the TQPS-20 


Operator's Guide. 


allocates working disk storage capacity 
n (in pages) to the directory, and 
subtracts an equal number from the 
working disk storage capacity of the 
superior directory. Ordinarily, working 
and permanent storage limits are equal. 

Default n - 250 


Characteristics 


BUILD and "ECREATE 

The BUILD command is identical in format to the privileged 
"ECREATE command. If you use BUILD with Wheel or^Operator 
capabilities enabled, it has the same power as ECREATE, 
namely, to create directories and modify the parameters of 
any directory on the system. Without these capabilities, 
you can use BUILD to modify a more restricted set of 
directories: you can modify a directory if you have write 
access to the immediately superior directory. The LOGIN, 
CONNECT, or ACCESS command obtains write access to the 
superior directory; or, if you have sufficient group rights 
to the superior directory, you can use BUILD to modify its 
subdirectories. 

More Information 

For a description of using "ECREATE to create directories, 
see the TQPS-20 Operator's Command Language Reference 
Manual . 

Quotas Subtracted from the Superior Directory's Allotments 

Working and permanent disk storage page limits, and the 
maximum number of subdirectories allowed to a subdirectory 
are subtracted from the quotas allocated to the immediately 
superior directory. This subtraction occurs at the time of 
their allotment to a subdirectory. If the superior 
directory's quota is not sufficient, the BUILD command will 
fail. To increase the superior directory's quota of any of 
these quantities you must either kill some of its 
subdirectories or reduce their allotments of the quantity. 
Or you can ask the system manager to increase the allotment 
of the superior directory. Remember that unless you specify 
working and permanent page limits, they will assume a 
default value of 250 pages. The BUILD command will fail in 
this case if there are not at least 250 pages free in the 
immediately superior directory. 
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Assigning Infinite Quotas 

If you have Wheel or Operator capabilities enabled, you can 
assign the maximum storage limit of 34359738367 (i.e., 
2**35-l) to a directory. This will appear in the response 
to an INFORMATION DIRECTORY command as +INF, denoting 
infinite storage capacity. If you then use the BUILD 
command to construct subdirectories to this directory, any 
disk storage capacity assigned, even the maximum, will not 
be subtracted from the superior directory. You can use this 
feature to assign infinite storage capacity to a number of 
users sharing a private structure. Then these users may use 
storage space on the structure without limit until the disk 
pack fills up. 


Hints 


Keeping Track of Subdirectories 

Subdirectories appear as files of type .DIRECTORY in the 
immediately superior directory, so the DIRECTORY *. DIRECTORY 
command for the superior directory will indicate any 
existing subdirectories. To suppress the listing of these 
files you can use the SET FILE PROTECTION command to give 
them a protection of 000000, but then you must specify the 
files completely (including generation number) to access 
them in the future. 

If there are two or more levels of subdirectories below a 
superior directory, you can do something else to allow a 
listing of them: put each subdirectory into a group of 
which the owner of the highest-level superior directory is a 
member. Then, if you obtain the group rights of this owner 
(e.g., by using the LOGIN or ACCESS command if the superior 
directory is on PS:, or ACCESS if it is on another 
structure) , the INFORMATION DIRECTORY <d ir ec tory . *> command 
with the NAME-ONLY subcommand will produce a listing of 
subdirectories at every level beneath the superior 
directory. For this feature to operate properly the group 
field of each subdirectory's protection code must be at 
least 40. 

Modifying Subdirectories Easily 

By following the above procedure, that is, by making 
subdirectories at every level members of groups of which the 
owner of the highest-level superior directory is also a 
member, you make the modification of these subdirectories 
much easier. You can use the BUILD command to modify these 
subdirectories or read and write to them, as long as you 
have the group memberships of this owner. You need not 
connect to each subdirectory's immediate superior to make 
modifications . 
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Restr ictions 


Giving Capabilities to Subdirectory Owners 

In order to give capabilities (Wheel, Operator, 
Absolute-Ar panet-Socke ts , Arpanet-Wizard, Confidential, 
Enq-Deq , IPCF, or Maintenance) to a subdirectory owner, you 
must have these capabilities yourself, and they must be 
enabled at the time of the BUILD command. Wheel and 
Operator capabilities allow you to assign any capabilities. 
The INFORMATION DIRECTORY command for your log-in directory 
tells you which capabilities you have, if any. 

Modifying Other Directories 

Unless you have Wheel or Operator capabilities enabled, you 
can use the BUILD command to modify the parameters of only 
those directories subordinate to a directory to which you 
have write access. (See Characteristics - BUILD and 
"ECREATE, and Hints - Modifying Subdirectories Easily, 
above.) If your installation allows it, you can use the SET 
DIRECTORY command to change some parameters of these 
directories. 

Files-only Directories 

By giving the FILES-ONLY subcommand you make the directory a 
files-only directory (see Figure 1) . A files-only directory 
is not associated with a user and so should not be given 
capabilities or user group memberships. Although a 
files-only directory can have subdirectories, none of these 
can be a user directory. You cannot give the ACCESS or 
LOGIN command for a files-only directory. 

Killing Directories 

You cannot kill a directory that has subdirectories; first 
you must kill those subdirectories one by one. (When you 
kill a directory, the files it contains are deleted and 
expunged.) Also, you cannot kill a directory if you are 
logged into it or connected to it, or there are open files 
on it . 


Effect on Memory and Terminal 

The BUILD command does not affect memory and leaves your terminal 
at BUILD subcommand level. 
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Related Commands 


INFORMATION DIRECTORY for examining the parameters 

established for a directory 

INFORMATION DISK-USAGE for determining how much of a 

directory's disk space is already 
assigned to files 

SET DIRECTORY for changing certain directory 

parameters 


<CHEM> 



<CHEM. ALLEN. LAB > CCHEM . BLAKE . LAB> 

(files-only) (files-only) 


Figure 1 Directories and Subdirectories 
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Examples 


The examples show how a user with a directory named <CHEM> builds 
subdirectories in the pattern shown in Figure 1. 

1. Build directories for two of your students or employees, 
assigning disk space and passwords and placing them in one of 
your directory groups; check their parameters. 

B BUILD (CHEM . ALLEN > 

[NEW] 

BB WORKING 50 
B6 PERMANENT 50 
BB PASSWQRD G19JIM 
BB DIRECTDRY -GROUP 2391 
BB LIST 

NAME CCHEM . A L L E N > 

Password B 1 9 J I M 

Working disk storage paSe limit 50 
Permanent disk storage p a 3 e limit 50 
Account default for LOGIN - none set 
Director 1 / Sroups 2391 

BB 

B BUILD CCHEM . BLAKE > 

[New] 

BB WORKING 50 
BB PERMANENT 50 
BB PASSWDRD 1Z7BIL 
BB DIRECTDRY -GROUP 2391 
BB LIST 

Name < CHEM. BLAKE > 

Password 127BIL 

Working disk storase paSe limit 50 
Permanent disk s t o r a 9 e p a 9 e limit 50 
Account default f o r L 0 G I N - none set 
Directory 9roups 2391 

BB 

B 


2. Modify Blake's directory to allow him to create 2 
subdirector ies . 

B BUILD < CHEM, BLAKE > 

[Old] 

B6 MAXIMUM-SUBDIRECTQRIES 2 

BB 

B 


3. Build a files-only directory to store examination questions. 

B BUILD CCHEM. TESTS > 

[New] 

BB FILES-QNLY 
BB WORKING 10 
BB PERMANENT 10 
SB PASSWORD MINEROA 


BB DIRECTORY -GROUP 2391 
B 
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4. Build a files-only directory as a library directory for your 
subdirectory owners. Place the directory and these users in 
the same group. 

B BUILD CCHEM, LAB -NOTES)- 
[New] 

BB FILES-ONLY 

BB HQRK I NG 25 

@@ PERMANENT 25 

BB PRQTECT I ON 774000 

BB DEFAULT-FILE-PROTECTIQN 775200 

BB DIRECTQRY -GROUP 2392 

BB 

@ BU I LD CCHEM, ALLEN)- 
[Old! 

BB USER-GRQUP 2392 
@@ 

B BUILD < C H E M , BLAKE > 

[Old] 

BB USER-GRQUP 2392 

BB 

@ 

5. User Blake quits. Delete his directory. 

B BUILD CCHEM. BLAKE)- 
[Old] 

BB K ILL 
[ C o n f i r m ] 

BB 

B 

6. Modify a subdirectory so that the subdirectory's owner will 
have 350 disk pages available. 

B BUILD (DIRECTORY NAME) C TUCKER . TEST > (PASSWORD) EXAMPLES 
[Old] 

BB PERMANENT (DISK STORAGE PAGE LIMIT) 350 
BB 

?Req Lies t exceeds superior directory permanent quota, 

Please fix incorrect subcommands. 

The action above produced an error message. To correct the 
error , PUSH out of the BUILD session to learn what the 
superior directory's permanent quota is. 

BB PUSH 

T 0 P S - 2 0 Command processor 5(702) 

6 INFQRMATIQN (ABOUT) DISK-USAGE ( OF D I RECTORY ) <TUCKER> 

PS : < TUCKER > 

70 Pa Jes assigned 

2B1 Work ind p a d e s , 2B1 Permanent p a d e s allowed 
7546 Fades free on PS: t 144454 pades used. 

Then return to the BUILD session, and specify a permanent 
quota that is less than the superior directory's quota of 261 
disk pages. 

B POP 

[Corit inuin d BUILD of directory PS :< TUCKER . TEST > ] 

BB PERMANENT (DISK STORAGE PAGE LIMIT) 170 

BB 

B 
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Function 

The CANCEL command withdraws requests made with a previous 
queue-class command. 

Format 

0CANCEL (REQUEST TYPE) queue (ID) identif ier/switch (es) 
where 

queue is the name of the queue, chosen from 

following list: 

ARCHIVE for requests made using 
ARCHIVE command 


BATCH 

for requests 
command 

made 

using 

the 

SUBMIT 

CARDS 

for requests 

made 

using 

the 

PUNCH 


CARDS command 




MOUNT 

for requests 

made 

using 

the 

MOUNT 


STRUCTURE or 

MOUNT 

TAPE 

command 


PAPER-TAPE 

for requests made using 
PAPER-TAPE command 

the 

PUNCH 

PLOT 

for requests made using 
command 

the 

PLOT 

PRINT 

for requests made using 
command 

the 

PRINT 

RETRIEVE 

for requests made 

RETRIEVE command 

using 

the 


identifier is one of the following: 

request ID number 

the unique identifier assigned 
by the system to your request. 
This is the number appearing 
under the heading "Reg#" in 
the list of requests shown by 
the appropriate INFORMATION 
command (see Related Commands, 
below) . To cancel archival 
requests, use "filespec" 
argument instead. 
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/switch 


j obname 

the jobname of the request, 
either the first six 

characters of the first 
filename in the request or the 
argument you supplied to a 
/JOBNAME switch when making 
the request (for output and 
batch requests) , or the first 
six characters of each 
filename in the request (for 
retrieval requests), or the 
first six characters of the 
structure alias or tape set 
name (for mount requests). 
This is the name appearing 
under the heading "Name", "Req 
Name", or "Job Name" in the 
list of requests shown by the 
appropriate INFORMATION 

command (see Related Commands, 
below) . 

filespec the specification of a file. 

Use this argument to cancel 
archival requests. 

Use an asterisk (*) as identifier to cancel 

all your requests in the specified queue. 

is one or more of the following switches: 

/JOBNAME : j obname 

which gives the jobname of the 
request you want to cancel . 
See Special Cases - /JOBNAME 
Switch, below. 

/SEQUENCE : n which gives the sequence 
number of the batch or output 
request you want to cancel. 
The INFORMATION BATCH-REQUESTS 
or INFORMATION OUTPUT-REQUESTS 
command with the /ALL switch 
gives the sequence number 
assigned to these requests. 
Use this switch in CANCEL 
commands placed within batch 
jobs: then you can cancel 

requests made earlier in the 
batch job even though you do 
not know the request ID 
number . 
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/USERruser name 

which cancels the specified 
request entered under the 
given user name. Use an 
asterisk (*) both for request 
ID number and as argument to 
this switch to cancel all 
requests of all users in the 
specified queue. For 

privileged users only. 

Output 


When you complete a CANCEL command removing a request, the system 
responds with "[1 Job Canceled]" and makes the appropriate 
deletion from the indicated queue. If the job is being 
processed, the response is "[1 Job Canceled (1 was in 
progress)]", but if the job is already finished, it is simply 
"[No Jobs Killed]". 


Characteristics 


Request ID or Jobname as Argument to CANCEL 

You can cancel a single queue request (those made with 
Queue-class commands - MOUNT, PLOT, PRINT, PUNCH, RETRIEVE, 
or SUBMIT) by giving either its request ID number or its 
jobname as the second argument of a CANCEL command. This 
argument is interpreted as a request ID number unless it 
includes one or more non-numeric characters. If the 
argument includes non-numeric characters it is interpreted 
as a jobname. By giving a jobname as the second argument of 
a CANCEL command, you cancel all your requests of that 
jobname in the specified queue. But see also Special 
Cases - /JOBNAME Switch, below. 


Special Cases 


/SPOOLED-OUTPUT Switch 

You can give the special switch, /SPOOLED-OUTPUT, after the 
CARDS, PAPER-TAPE, PLOT, or PRINT argument to the CANCEL 
command. By doing so you cause any accumulated requests in 
the spooler queue for the appropriate output device (CDP: , 
PTP : , PLT : , or LPT:, respectively) to be canceled, rather 
than filled when you log out. Do not give any further 
arguments to a "CANCEL queue /SPOOLED-OUTPUT" command. 
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/JOBNAME Switch 

In the singular case when you want to cancel several queue 
requests of the same jobname using a single command, and 
that jobname is purely numerical (for example, 5045), you 
must use the /JOBNAME : jobname switch as the second argument 
to the CANCEL command. Do not also give the request ID or 
jobname as a command argument if you give the 
/JOBNAME : jobname switch. 


Restrictions 


Cannot Cancel Filled Tape-mount Requests 

You cannot use the CANCEL command to withdraw a MOUNT TAPE 
request once the first volume of tape has been mounted 
(i.e., once you have received a message of the form, 
[setname defined as MTn : ] ) . Use the DISMOUNT command to 
give up your tape resource in this case. Note that the 
DEASSIGN or LOGOUT command will also dismount the tape set. 

Cannot Cancel Certain Archival Requests 

You cannot use the CANCEL command to withdraw an archival 
request once the operator has initiated archival procedures. 
Thus, even though files remain on disk between the 
operator's first and second archive runs, you cannot cancel 
a request during this time. If you try to cancel a request 
after archiving has begun, you receive the error message: 

?File has archive status: filename 

Note that this error does not terminate a multifile CANCEL 
ARCHIVE command (for example, CANCEL ARCHIVE *.*); the 
TOPS-20 command processor continues processing each 
remaining filename in the request. Cancel requests for 
these remaining files are judged individually. 


Effect on Memory and Terminal 


The CANCEL command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


ARCHIVE for requesting archival of a file 

INFORMATION ARCHIVE-STATUS for finding out the archival 

status of files 
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INFORMATION BATCH-REQUESTS 

INFORMATION MOUNT-REQUESTS 
INFORMATION OUTPUT-REQUESTS 

INFORMATION RETRIEVAL-REQUESTS 

MODIFY 

MOUNT 

PLOT 

PRINT 

PUNCH 

RETRIEVE 

SUBMIT 


for examining requests in the 

batch input queue 

for examining requests in the 

structure- and tape-mount queue 

for examining requests in the 

line printer, plotter, card 
punch, and paper tape punch 
queues 

for examining requests in the 

retrieval queue 

for changing requests without 
removing them 

for placing requests in the 

structure- or tape-mount queue 

for placing requests in a plotter 
queue 

for placing requests in a line 
printer queue 

for placing requests in the 

card- or paper-tape-punch queue 

for placing requests in the 

retrieval queue 

for placing requests in the batch 
input queue 


Examples 


1. Cancel a specific print request. 

B CANCEL PRINT REMAX 
C 1 JOB CANCELED] 

@ 

2. Cancel all your batch requests. 

B CANCEL BATCH * 

C 3 JOBS CANCELED] 

@ 
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Find out what line printer requests you have made, then 
cancel one of two jobs bearing the same jobname. 

@ I NFQRMAT I ON OUTPUT -REQUESTS /USER 

Printer Queue: 


Job Name 

Re q « 

Limit 

User 




MYCOPY 

142 

81 

LATTA 

/Lowe r 

/After: 8- 

N o u - 7 9 

MYCOPY 

143 

81 

LATTA 

/ Af t e r 

8-No u -73 

18:00 

MYCOPY 

144 

81 

LATTA 

/After 

8-No u -79 

18:00 

HOLMAX 

141 

2 0 0 

LATTA 

/ Af t e r 

8-No u -79 

17:00 

HOLMAX 

140 

2 0 0 

LATTA 

/ A f t e r 

B-Nou-79 

1 8 : 00 

There are 

5 Jobs in 

the Queue 

(None 

in Progress) 



B CANCEL PRINT 141 
Cl Job Canceled! 

@ 
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4. Get a list of your printing jobs (and some of the switches 
you gave) , then cancel three of them. 

@ I NFQRMftT I ON OUT PUT - REQUESTS /ALL/USER 
Printer Queue: 


Job Name 

Req# 

Limit 

User 


MYCOPY 

142 

81 

LATTA 

/Lower /After: 8-No u -79 


/ P r i o 

: 20 

/Seq : 172B 

MYCOPY 

143 

81 

LATTA 

/After: B-Nou-79 18:00 


/Seq : 

1728 



MYCOPY 

144 

81 

LATTA 

/After: B-Nou-79 18:00 


/Seq : 

1730 



HOLMAX 

140 

2 0 0 

LATTA 

/After: B-Nou-79 18:00 


/Seq : 

1726 



There are 

4 Jobs in the Queue (None 

in Progress) 


E CANCEL PRINT MYCOPY 
[3 Jobs Canceled] 

E 


5. Cancel a plotter request. 

E CANCEL PLOT 9 A 
Cl Job Canceled] 

E 

6. Cancel a mount request for a structure or a tape set. 

E CANCEL MOUNT 24 

Cl mount request canceled] 

E 

7. Find out what requests are in the mount queue. Cancel your 
structure mount request. 

S I NFQRM AT I ON MOUNT -REQUESTS 
Tape/Disk Mount Queue: 


U olume 

Status 

Type 

Write 

Req Name 

Req# 

Job# 

User 

MARK 

MT A 1 

Tape 

Enabled 

MARK 

126 

60 

HOUSEPI AN 

TAPE 

MT A3 

Tape 

Enabled 

TAPE 

148 

13 

WALLACE 

LATB 

Waiting 

Disk 


LATB 

157 

65 

LATTA 


There are 3 Requests in the Queue 

E CANCEL MOUNT 157 
Cl mount request canceled] 

E 
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8. Find out what requests are in the mount queue. Cancel a 
mount request that has not yet been filled, and dismount a 
tape that has been mounted. 

@ INFORMATION MOUNT - REQUESTS 
T a p e / D i s K Mount Queue: 


V o 1 u m e 

Status 

Type 

Write 

R e q Name 

Req# 

Job# 

User 

MARK 

MT A 1 

Tape 

Enable d 

MARK 

29 

15 

HOMSEPI AN 

DBL02 

MTAO 

Tape 

Enable d 

LAT 

31 

24 

LATTA 

NCV19 

Waiting 

Tape 

Enable d 

NCU 

32 

24 

LATTA 


There are 3 Requests in the Queue 

B CANCEL MOUNT 32 

Cl mount request canceled] 

6 D I 5M0UNT TAPE LAT : 

[Tape dismounted t logical naue LAT : deleted] 
@ 
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Function 


The CLOSE command closes files in your job and releases their 
JFNs . 


Format 


0CLOSE ( JFN) n 
where 

n is the JFN (Job File Number) of a file 

Default n - all JFNs for open and closed files 


Output 


When the CLOSE command is completed, the system prints a message 
on your terminal for each JFN that it has closed or attempted to 
close . 


Characteristics 


CLOSE Usually Unnecessary 

The CLOSE command is used to preserve the contents of a file 
after the abnormal termination of the program that opened 
it. Under ordinary conditions you do not need to use the 
CLOSE command. 


Special Cases 

CLOSE For Closed Files 

If you give the CLOSE command for an existing but closed 
JFN, the JFN is released. 


Restr ictions 


Closing Mapped Files 

You cannot close files that are mapped into memory; in this 
case you may give the RESET command, which clears memory. 
(Note, however, that RESET will delete and expunge a mapped 
file if the file is new, rather than save it as CLOSE would. 
To save a new mapped file, give the SET PAGE-ACCESS 0:777 
NONEXISTENT command, and follow this with CLOSE.) If RESET 
by itself does not close the file, you may first have to 
give the POP command to return to a higher level of the 
TOPS-20 command processor; then give the RESET command. 
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Once memory has been cleared, all files are closed for processes 
at the current and lower levels of TOPS-20. 


Effect on Memory and Terminal 


The CLOSE command does not affect memory and leaves your terminal 
at TOPS-20 command level. 


Related Commands 


INFORMATION FILE-STATUS for determining which files are open 

in your job 

INFORMATION MEMORY-USAGE for determining which files are 

mapped 

RESET for closing mapped files and clearing 

memory 


Examples 


1. Close an open file. 

B CLOSE a 

a EDIT-BUFFER. OUT. 10003B [OKI 

@ 

2. Try to close all your open files. Give the RESET command to 
close those that are mapped. (Note that the file EXEC . EXE , 
containing the TOPS-20 command processor, cannot be closed.) 

UCLOSE 

3 TEST 1 , CBL . 1 COK] 

2 PS :< LOADTESOEDIT.EXE. 4 Can't close file - File 
still mapped 

1 PS s< SYSTEM >EXEC. EXE. 153 Can't close file - File 
still mapped 
BRESET 
BCLOSE 

1 PS:<S Y STEM > EXEC. EXE. 153 Can't close file - File 

still mapped 
B 
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Function 


The COMPILE command translates source files into object 
(relocatable binary) files. 


Format 


0COMPILE (FROM) /switch (es) source/switch (es) object,... 
where 


switches are keywords chosen from the list below, 

indicating your choice of COMPILE command options. 
They have different effects depending on their 
position in the command line: placed before all 
files in the command, they act as defaults for 
all; otherwise, they affect only the nearest 
preceding file. 

Defaults are shown in the list of switches 


source is the file specification of a source program. 

The filename must be of 6 or fewer characters, and 
the file type of 3 or fewer characters; you 
cannot use a generation number. 

Default - arguments you gave in your last 
LOAD-class command 


object 


is the filename you choose for the object file; 
it must be of 6 or fewer characters. 

Default - filename of the source file (file 
type is .REL) 

means that, after commas, you can give more 
arguments of the form already shown 


Summary of COMPILE Command Switches (defaults in boldface) 


/ 6 8-C0E0L 

/74-COBOL 

/ALGOL 

/BINARY 

/COBOL 

/COMPILE 

/CREF 

/DEBUG 

/FORTRAN 

/LANGUAGE-SWITCHES: "/switch (es) " 

/LIST 

/MACRO 

/NOBINARY 

/NOCOMPILE 

/NODEBUG 

/NOLIST 

/NOOPTIMIZE 

/OPTIMIZE 

/STAY 
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Descriptions of these switches are given below. Although the 
system will not reject switches described under any of the 
LOAD-class commands, only those switches commonly associated with 
COMPILE are described here. 


COMPILE Command Switches 


/68-COBOL 

/74-COBOL 

/ALGOL 

/BINARY 


/COBOL 


compiles the file using the COBOL-68 compiler 
Default for files of type .CBL 

compiles the file using the COBOL-74 compiler 

compiles the file using the ALGOL compiler 

allows generation of an object (binary) file for 
each source file given. Use this switch to cancel 
a /NOBINARY switch. 

Default 

compiles the file using the COBOL-68 compiler 


/COMPILE 


/CREF 


/DEBUG 


/FORTRAN 


forces compilation of the source file even if a 
current object file already exists. Use this 
switch along with the /LIST or /CREF switch to 
obtain listings when you have current object 
files. (See also the /NOBINARY switch.) 

creates a file containing cross-reference 
information for each compilation. The filename is 
that of the object file; the file type is . CRF . 
Use the CREF command to obtain a listing of the 
file. (For COBOL files, this switch automatically 
produces a cross-reference listing.) See the 
TOPS-20 User Utilities Guide for information about 
the CREF program. 

produces an object file containing debugging 
information beyond what is usually inserted during 
a compilation. (For FORTRAN programs only, and 
only if you have not given the /OPTIMIZE switch.) 

compiles the file using the FORTRAN compiler 

Default for switches specifying compiler 
language, in the absence of a 
standard source file type 


/LANGUAGE-SWITCHES; "/switch (es) " 

passes the specified switches to the compiler that 
will process the file(s) to which this switch 
applies. You must include the switches in double 
quotation marks (" "). 

/LIST prints a listing of the program in ASCII format; 

the name of this listing is the filename of the 
object file. The /CREF switch overrides /LIST 
when they both apply to the same file. 
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COMPILE Command Switches 


/MACRO assembles the file using the MACRO assembler 

/NOBINARY prevents generation of an object (binary) file. 

Use this switch along with /LIST or /CREF to allow 
these switches to take effect without producing a 
new object file. 

/NOCOMPILE prevents compilation if the associated object file 

is current; otherwise it forces compilation. Use 
this switch to cancel a /COMPILE or /RELOCATABLE 
(see the EXECUTE command description) switch. See 
Characteristics - Compiling New Sources Only, 
below . 

Default 

/NODEBUG excludes special debugging information from your 

object file. (For FORTRAN programs only.) 

Default 

/NOLIST prevents a line printer listing of the program 

Default 

/NOOPTIMIZE prevents the generation of a globally optimized 

object file. (For FORTRAN programs only.) 

Default 

/OPTIMIZE calls for generation of a globally optimized 

object file, that is, one that runs as quickly as 
possible. (For FORTRAN programs only, and only if 
you have not given the /DEBUG switch.) 

/STAY returns your terminal to TOPS-20 command level so 

that you can perform other work while the system 
continues to compile your program. You 

immediately receive the TOPS-20 prompt (@ or $) , 
and can then issue any user command. But be 
careful with commands that run programs, because 
those commands may clear memory and terminate the 
current process. Also, you could easily send 
incorrect data to programs expecting terminal 
input. This switch saves you from having to: 
issue a "T to make sure the compiler has begun; 
give a ~C to halt compilation; and issue a 
CONTINUE STAY command to remain at command level 
during compilation. 


Characteristics 


Compiling New Sources Only 

The system usually compiles only those sources for which 
there are no current object files, that is, sources whose 
write dates are more recent than those of the object files 
of the same name. 
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COMPILE Command Switches 


However, sources for which you supply a new object filename 
are compiled even if there are current object files. You 
can always force compilation with the /COMPILE switch. 


Using Standard File Types 

If you specify source files with standard types (.FOR, .MAC, 
. CBL , or .ALG) in a COMPILE command, the system 
automatically calls the appropriate compiler when 
compilation is necessary. If you specify source files by 
filename only, the system searches your connected directory 
in the above order for a file of this name and a standard 
type. To compile programs from sources that have 
nonstandard file types, give a switch to indicate the proper 
compiler (/FORTRAN, /MACRO, /COBOL, or /ALGOL). A switch 
will take precedence over a standard file type if they 
indicate different languages. If no compiler is indicated 
with either a switch or a standard file type, the FORTRAN 
compiler is used. 


Hints 


Plus Signs Between Filespecs 

If you give two or more filespecs separated by plus signs 
(+) as arguments to COMPILE, they are compiled together as 
if they were a single file. Their object module is stored 
under any filename given as the "object" argument of the 
command, or (if none) under the last filename in the group 
and file type .REL. 

Indirect Files as Arguments 

You can store the arguments (source and object filespecs, 
switches) of a COMPILE command in an indirect file, and 
specify them by typing an at sign (@) and its filespec as a 
COMPILE command argument. 

Establishing Default Arguments with the SET Command 

You can issue the SET DEFAULT COMPILE-SWITCHES command to 
set up default global arguments to the COMPILE command. 
Insert this SET command in your COMAND.CMD file to change 
your own defaults permanently. 
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Restrictions 


Switches Assuming Compilation 

/CHEF 

/DEBUG 

/LANGUAGE-SWITCHES 

/LIST 

/NODEBUG 

/NOLIST 

/NOOPTIMIZE 

/OPTIMIZE 

The above switches will not take effect unless the COMPILE 
command causes a new compilation of the relevant source 
file. See Characteristics - Compiling New Sources Only, 
above, for more information. 


Effect on Memory and Terminal 


The COMPILE command clears memory and loads the appropriate 
compiler. After the compilation your terminal is left at TOPS-20 
command level. 


Related Commands 


LOAD, EXECUTE, and DEBUG other LOAD-class commands for 

performing related functions 


Examples 


1. Compile a FORTRAN program. 

e COMPILE R5D2 . FDR 
FORTRAN: RSD2 
MAIN . 

@ 

2. Do the same thing, using a switch to indicate the proper 
compiler. Use the /STAY switch to return immediately to 
TOPS-20 command level. 

B COMPILE RSD2/F0RTRAN/5TAY 
B PUSH 

B ED I T L0GIN.CMD 

3. Create an indirect file. Use it to compile several programs, 
forcing a compilation of the last one and storing its object 
file under a new name. 
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B CREATE UPDftTE , CMP 
Input : UPDATE . CMD , 1 

00100 /COBOL FSTO » SNDO > THDO > FTHO/ COM PILE ANNUAL 
0 0 2 0 0 $ 

*E 


CUPDATE.CMD. 1] 
BCOMPILE BUPDATE . CMD 


COBOL : 

DMN 

CFSTQ . CBL] 

COBOL : 

DMN 

CSNDO . CBL ] 

COBOL: 

DMN 

[THDO.CBL] 

COBOL: 

DMN 

[FTHO.CBL] 


EXIT 

6 DIRECTQRY . 

BB CHRONQLQGICAL LIRITE 
@@ REVERSE 
BB 

PS : < LATT A > 

ANNUAL. REL. 1 

THDO . REL . 1 

SNDO. REL. 1 

FSTO. REL. 1 

UPDATE , CMD . 1 

017CRE.TMP. 100017 5T 

FTHO.CBL 

THDO.CBL 

SNDO . CBL 

FSTO . CBL 

Total of 10 files 

@ 

4. Produce a cross-reference ( . CRF) file for a FORTRAN program 
although you already have a current object file; prevent the 
generation of a new object program. Check for the output 
file . 

B COMPILE /CREF/FORTRAN/CQMPILE/NOBINARY RSD2 

FORTRAN: RSD2 

MAIN. 

^ DIRECTORY > 

BB CHRONQLQGICAL URITE 
@@ REVERSE 
@@ 


PS : < L ATT A > 
RSD2.CRF. 1 
017CRE.TMP. 1000175T 
RSD2.REL. 1 
RSD2 . FOR 

Total of A files 
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Function 


The CONNECT command obtains ownership rights to a directory and 
makes it your connected directory. 


Format 


@ CONNECT (TO DIRECTORY) dev : <dir ectory> 

PASSWORD: password 

e 

where 

dev : <directory> is the directory to which you want to connect 

Default dev: - your connected structure 

Default <directory> - the directory (on 
the specified structure) of the 
same name as your connected 
directory 

Default (if no arguments are given) 
your log-in directory on PS: 

password is the password of the directory (not 

requested for your log-in directory or a 
directory to which you already have ownership 
or sufficient group rights) 


Characteristics 


Capabilities 

Your capabilities (Wheel, Operator, Confidential, etc.) are 
associated with your log-in user name only. If you connect 
to a directory whose owner has Wheel capabilities, you do 
not gain these capabilities. 


Hints 


Obtaining Group Rights 

You can obtain group rights equal to those of the owner of a 
directory by giving the ACCESS command instead of, or in 
addition to, CONNECT for that directory. 


Restr ictions 


Features Not Affected 

For some system features, CONNECT does not affect the 
directory used: 
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Mail 

The MAIL program inserts messages addressed to you into 
a file in your log-in directory only. The RDMAIL 
program reads messages from this file only, unless you 
are a privileged user. 

System Accounting 

The SET ACCOUNT command allows arguments valid for your 
log-in user name only. Generally, charges for system 
use are made to your log-in user name. 

Queue-class Commands 

The Queue-class commands charge processing requests to 
your log-in user name only. 

Effect on Memory and Terminal 


The CONNECT command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


ACCESS 


MOUNT 


Examples 


1. Connect to another user's directory. 

e CONNECT (HOLLAND) 

P a s s u o r d : 

e 

2. Try to access a directory. Discovering that it is a 
files-only directory, connect to it instead. 

B ACCESS < MANUALS-? 

?Di rectory is "files-only" and cannot be accessed 
6 CQNNECT < MANUALS > 

Password: 

@ 


for obtaining group as well as ownership rights equal 
to those of the owner of a directory 

for making a structure available for connecting and 
ensuring the continued availability of the structure 
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3. Connect to another user's directory on a different file 
structure and then to your directory on that structure; then 
return to your log-in directory on PS;. Give INFORMATION 
JOB-STATUS commands as you go along to check which is your 
connected directory. 

E INFORMATION JOB 

Job 36 i User LATTA > Account 341 > TTY207 
B MQUNT STRUCTURE SNARK : 

Structure SNARK; mounted 
B CONNECT SNARK : < HOLLAND)- 

Password: 

e iNFORMATION JOB 

Job 36 , User LATTA > SNARK : < HOLLAND > > Account 341 » TTY207 
B CONNECT < LATTA > 
e iNFORMATION JOB 

Job 36 » User LATTA . SNARK : < LATT A > t Account 341 t TTYZ07 
B CONNECT 
e iNFORMATION JOB 

Job 36 , User LATTA » Account 341 , TTY207 
B DISMOUNT STRUCTURE SNARK: 

Structure SNARK: dismounted 

e 

4. Connect to your directory on another structure and obtain 
your full rights to it. After giving an INFORMATION 
JOB-STATUS command to verify your connected directory, give a 
command that depends on these rights. Then return to your 
log-in directory on PS:. 

B MOUNT STRUCTURE SNARK: 

Structure SNARK: mounted 
B ACCESS SNARK : 

B CONNECT SNARK : 

B INFDRMATIDN JOB 

Job 36 t User LATTA » SNARK :< LATTA > t Account 341 t TTY207 
e iNFORMATION DIRECTORY (LATTA.* > > 
eB NAME-ONLY 

ee 

Name SNARK :< LATTA . ALLEN > 

Name SNARK: < LATTA. BLAKE> 

Name SNARK :< LATTA. LAB- NOTES > 

Name SNARK : < LATTA. TESTS > 

B END-ACCESS SNARK : (LATTA > 

B CONNECT 

B DISMOUNT STRUCTURE SNARK: 

Structure SNARK: dismounted 

e 
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Function 

The CONTINUE command resumes execution of a proqram that is 
halted. 

Format 


@CONTINUE (PROGRAM) argument 
where 

argument is one of the following keywords: 

NORMALLY - which directs your program to resume 
executing and restores your terminal 
to command level (if any) within the 
program 

STAY - which directs your program to resume 
executing but keeps your terminal at 
TOPS-20 command level 

Default - NORMALLY 


Hints 


Stopping Your Program or Providing Input After CONTINUE STAY 

If you have given the CONTINUE STAY command and you then 
wish to stop your continued program or send terminal input 
to it, you must first give a CONTINUE NORMALLY command, to 
restore your terminal to program command level. Then you 
can give CTRL/Cs to stop the program, or type the input that 
is required. 

Monitoring your Program 

CONTINUE STAY, by keeping your terminal at TOPS-20 command 
level, lets you use TOPS-20 commands to monitor the proqress 
of your program (see Related Commands, below) while it is 
running. You can also do other work as long as the commands 
you use do not affect memory. See Appendix B for a list of 
these. 

Using PUSH to Get a New TOPS— 20 Command Level 

To use commands that call a program or otherwise affect 
memory, or to start a second program while the first one is 
running, give a PUSH command immediately after CONTINUE 
STAY. You receive a fresh copy of memory (address space) 
and can then give commands that affect memory or call 
programs. These commands do not affect the program that is 
already running. But see Restrictions, below. 


56 



CONTINUE (Cont.) 


Restr ictions 


Similar Programs Competing for Files 

If you have two similar programs running at once after using 
CONTINUE STAY and PUSH commands (see Hints, above), they may 
try to access the same files at the same time (e.g., 
temporary files labeled by job number, used by compilers). 

This may cause unpredictable situations to develop. To 
avoid the possibility, run different kinds of program or 
give different kinds of command (e.g., a LOAD-class command 
and an EDIT-class command) at the different levels in your 
job . 

Programs Competing for Terminal Input 

If you have two programs running at once after CONTINUE STAY 
(see Hints - Using PUSH to Get a New TOPS-20 Command Level, 
above) , it is possible for the program running at the higher 
(first) TOPS-20 command level to intercept TOPS-20 commands 
given at the lower level. These can be interpreted as 
commands or data directed at the higher-level program. If 
you suspect that this is happening, you can stop it by first 
typing CTRL/Cs to be sure you are at the lower TOPS-20 
command level. Then give POP commands to return to the 
higher TOPS-20 level. You may have to type more than one 
POP command because terminal input is being divided 
arbitrarily between the two levels. POP stops the 
lower-level program and erases its copy of memory. Finally, 
give CTRL/Cs followed by a CONTINUE NORMALLY command; this 
puts you at program command level in the higher-level 
program so you can give the commands or data it requires. 

Commands That Affect Context of Job 

Certain commands, by altering the context of your job, can 
affect programs you are running without changing memory. 
ACCESS, CONNECT, and DEFINE are examples. Give these 
commands with caution after CONTINUE STAY, even if you have 
given a PUSH command. 


Effect on Memory and Terminal 


The CONTINUE NORMALLY command does not affect memory, resumes 
processing the program in memory, and leaves your terminal at 
program command level (if there is one) . The CONTINUE STAY 
command also does not affect memory and resumes processing the 
program in memory, but leaves your terminal at TOPS-20 command 
level . 
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Related Commands 


DETACH CONTINUE 

INFORMATION FILE-STATUS 
INFORMATION MEMORY-USAGE 
INFORMATION PROGRAM-STATUS 


for disengaging your current job 
from your terminal and continuing 
the program that the job is 
running 

for monitoring files being written 
by your program 

for monitoring your program's use 
of memory 

for monitoring your program's use 
of CPU time 


PUSH 


REENTER 


START 


for obtaining a lower TOPS-20 
command level (and a fresh copy of 
memory) 

for starting your current program 
at its alternate entry point (if 
any) 

for starting your current program 
at the beginning 


Examples 


Continue a program that you have halted. 
SCONTINUE 


2 . 


Run a program, then halt it by typing 
CONTINUE command and proceed. 


CTRL/Cs. 


@RUN QUOTNT 


Give the 


type t w o n umbers: 312. A C 
@ CONT I NUE 
45 , G , S75 

the^uotient of 312.450 ouer G. 675 is 46.809 


END OF EXECUTION 

CPU TIME: 0.14 ELAPSED TIME: 35.62 
EXIT 
@ 
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3. Start editing a file. Type a CTRL/C (and then give the M 
(monitor) command to the EDIT system program) to return to 
TOPS-20 command level. Give the DIRECTORY command to check 
the name of a file, then give the CONTINUE command to return 
to your editing job. (Note that you must press the RETURN 
key twice after giving CONTINUE to see the EDIT program's 
prompt ( * ) . ) 

B EDIT REL3 A . MEM 
Edit: REL3A . MEM . 3 

* Y e s ? (Type H for help): M 
B P I RECTORY *.TXT 

PS : < LATT A > 

MAIL. TXT. 1 
MENTON . TXT . 1 
PROFIL.TXT. 1 
R20PRJ . TXT . 1 

Total of 4 files 
B CONTINUE 

* 


4. Begin editing a long file, giving the F (find) command to 
EDIT. Give a CTRL/C and then the M command to return to 
TOPS-20 command level. Give the CONTINUE STAY command and 
then INFORMATION FILE-STATUS commands to check the progress 
of EDIT as it searches through the file. (Notice that the 
byte position shown in response to successive INFORMATION 
FILE-STATUS commands grows larger.) Finally, give the 
CONTINUE NORMALLY command to return to EDIT so you can give 
more EDIT program commands. 

B EDIT DOC-PLAN. MEM 
Edit : DOC-PLAN. MEM. 1 
* FABCD$ 

Yes? (Type H for help) : M 
B CONTINUE STAY 
B I NFDRMAT I DN FILE-STATUS 
Connected to P S : < L A T T A > . JFNS: 

4 CLOADTESOEDIT.EXE. 4 Read , Execute 

3 EDIT-BUFFER. OUT. 100046 Read i Write t 0, (7) 

2 DOC-PLAN. MEM. 1 Read » 43520 .( 7 ) 

1 < S Y S T E M > E X E C , E X E . 153 Read .Execute 

Device assigned to/opened by this Job: TTY 222 

B I NFORMAT I ON FILE-STATUS 2 

2 DOC-PLAN. MEM. 1 Read. 1 1 2 G 4 0 . ( 7 ) 

B INFORMATIQN FILE-STATUS 2 

2 DOC-PLAN. MEM. 1 Read , 1 30560 .< 7 ) 

BCONTINUE 


* 


59 


CONTINUE (Cont.) 


5. Start compiling a long file. After compilation has begun, 
give a CTRL/C to stop it and return to the TOPS-20 command 
processor. Use CONTINUE STAY to resume compilation, and then 
PUSH to receive a new TOPS-20 command level. Edit a text 
file at this lower level, then give the POP and CONTINUE 
commands to return to the compilation in progress. The 
compiler finishes, in this case, after you have done so. 

@ C0MPILE DUMPER. MAC 
MACRO: DUMPER 

_C 

0 CONTINUE STAY 
@PUSH 


TOPS-20 Command processor 4(555) 
@ EDIT PROF I L . TXT 
Edit: PROF I L . TXT . 2 
* SAPRIL$JUNE$- ;* 

00100 JUNE 19 ( 1 97B 

00500 JUNE 12 

00750 JUNE 5 

00900 JUNE 18 

01400 JUNE 21 

*E 

CPROFIL.TXT .3 

e pop 

d CONTINUE 

EXIT 

@ 
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COPY 


Function 


The COPY command makes a copy of an existing file and stores it 
under a new file specification. The file remains under its old 
specification also. 


Format 


0COPY (FROM) source filespec (TO) destination filespec, 
@@subcommand 


where 

source filespec 
destination filespec 


@@subcommand 


is the specification of the file or 
device whose contents you want to copy 

is the specification of the file or 
device in which you want to store a copy 
of the file 

Default - same as source filespec 
but in your connected 
directory, if necessary 
using the next higher 
generation number 

means that after a final comma you can 
type an optional keyword, specifying the 
mode or format of information transfer, 
as described below 


COPY Command Subcommands 

(when used with the paper tape reader 
or paper tape punch - PTR : or PTP:) 

(PARITY 

ASCII (NOPARITY specifies that the file being copied is 

written in ASCII mode, with 36-bit words each 
consisting of five 7-bit bytes and a parity 
bit; the PARITY argument is not currently in 
use; NOPARITY (the default) means that the 
eighth hole of the paper tape is never 
punched . 

BINARY specifies that the file being copied is 

composed of 36-bit words, each consisting of 
six 6-bit bytes with the seventh hole of the 
paper tape set always to 0 and the eighth 
hole set always to 1; causes a checksum 
calculation. 
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COPY Commands Subcommands (Cont.) 

BYTE n specifies that the byte size of the 

destination file is to be n (any decimal 
number). If you do not give the BYTE 
subcommand, the destination file will have 
the same byte size as the source file. See 
also Hints - Viewing Display Screen Data 
below . 

IMAGE specifies that the file being copied is 

composed of 36-bit words, each consisting of 
one 8-bit byte; the 28 most significant bits 
are set to 0 on input and are lost on output. 

IMAGE BINARY same as BINARY, but lacking the checksum 

calculation 


COPY Command Subcommands 

(when used with devices other than the 
paper tape reader or paper tape punch) 


specifies that the file being copied is 
written in ASCII mode, with 36-bit words each 
consisting of five 7-bit bytes and a parity 
bit; the PARITY argument is not currently in 
use; NOPARITY (the default) means that the 
least significant bit is set to 0 on input 
and is lost on output. 

calls for a direct transfer of data in 36-bit 
bytes 

specifies that the byte size of the 
destination file is to be n (any decimal 
number). If you do not give the BYTE 
subcommand, the destination file will have 
the same byte size as the source file. See 
also Hints - Viewing Display Screen Data, 
below. 

same as BINARY 
same as BINARY 


( PARITY 

ASCII {NOPARITY 

BINARY 

BYTE n 

IMAGE 

IMAGE BINARY 

Output 


As each file is copied, the system prints the specifications of 
the source and destination files and the word [OK]. The delay 
before you see this [OK] indicates how long it took to copy the 
file : . Y ou use recognition on the destination file 
specification, the system prints, !New Generation!, 'New File!, 
or ! Super seding ! , to indicate the status of disk files, or !0K!, 
if the file is copied to a non-disk device. 
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Characteristics 


Normal Operation - No Subcommands 

For most purposes you do not need subcommands when copying 
files. When you do not use subcommands the information is 
copied as written, whether in a standard format (usually 
ASCII or BINARY) or not. 

Optional Subcommands With Paper Tape 

Each subcommand, when used to copy information from the 
paper tape reader ( PTR : ) , specifies an interpretation of 
eight-bit bytes, repr esentated as eight-hole lines on paper 
tape. When used with the paper tape punch (PTP:), each 
subcommand specifies a mapping of information to the 
eight-bit bytes of paper tape. 

Optional Subcommands With Other Devices 

Each subcommand can be used under particular conditions, 
e.g., when transferring files over network facilities (using 
DON : and SRV:), to specify the byte size of information 
being copied. In general, you can use COPY command 
subcommands whenever you need to specify the byte size of 
information being copied. 


Hints 


RENAME Faster Than COPY for Transferring Files 

For moving a set of files from one directory to another on 
the same structure, the RENAME command is a faster and more 
efficient means than COPY. 

Using Devices as Source and/or Destination Filespecs 

By specifying a device as the source and/or destination 
filespec, you can use the COPY command to transfer 
information between card- or paper-tape-handling devices, 
magnetic tape drives, line printers, terminals, or other 
output devices. However, the PLOT, PRINT, PUNCH and TYPE 
commands, and appropriate utility programs (e.g., DUMPER and 
EDIT) , offer more flexibility for most applications. 
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Copying To or From TTY: 

You can simulate the action of the CREATE command for 
creating files by copying from device TTY: to a new 
filespec, ending your input with a CTRL/Z ; use CTRL/U, 
CTRL/R, CTRL/W, and the DELETE key to edit the current 
line of terminal input. You can simulate the action of 
the TYPE command for displaying files by copying from 
an existing filespec to device TTY:. 

Viewing Display Screen Data 

If you specify TTY: as the destination filespec and 
then give the BYTE 8 subcommand, characters in the 
source file will be sent literally to your terminal. 
Do this to examine special display screen data. 

Spooled Output Action 

If you send information to output devices using the COPY 
command, your request is processed according to the status 
of the SPOOLED-OUTPUT-ACTION parameter, which you set with 
the SET SPOOLED-OUTPUT-ACTION command. 

Using Wildcards in Source and/or Destination Filespecs 

You can use wildcard characters (* and %) in source and/or 
destination filespecs to copy many files at a time. Default 
values will be assumed for filespec fields you do not 
specify. Note that if you use wildcard characters to copy 
more than one source file into a single destination file on 
disk, the contents of each source file will appear in a 
different generation of the destination file? the highest 
generation will contain a copy of the last source file only. 
Use the APPEND command to put the contents of several files 
into a single file. 

Specifying a New Account or Protection Number 

The COPY command lets you specify the new file's protection 
number, and the account to which storage fees for it will be 
charged. Follow the new file specification with a semicolon 
(?) and the letter P before giving a new 6-digit protection 
number, and with a semicolon and the letter A before giving 
a new account (which must be valid for your user name) . If 
you do not specify an account for a new file, it will take 
as default the account you gave in your most recent LOGIN or 
SET ACCOUNT command. However, non-default protection 
numbers will be maintained for higher generations of 
existing files, unless you specify otherwise in the COPY 
command that creates that higher generation. 
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Restr ictions 


Copying Archived Files 

You can make a copy of an archived file by specifying it as 
the first (or source) argument in a COPY command, and 
specifying a file of different name or type as destination. 
You can edit the new file, because it does not have archive 
status although it has the same contents as the original 
file. However, you cannot give the specification of an 
archived file as the second (or destination) argument of a 
COPY command, as this would replace the file's contents. If 
you attempt to do so, whatever source argument you supply 
will be copied into the next higher generation of the 
archived file, leaving the archived file intact. However, 
if you include the generation number when specifying an 
archived file as the second argument of a COPY command, the 
command will fail. 

Files of Type .DIRECTORY 

You cannot copy subdirectories, which appear as files of 
type .DIRECTORY in the immediately superior directory. 


Warning 


Destroying the Previous Contents of Files 

If you give a destination file specification that includes a 
generation number, the source file will be copied into that 
file, replacing any previous contents if that generation of 
the file already exists. Those contents cannot be 
recovered. But see Restrictions - Copying Archived Files, 
above . 


Effect on Memory and Terminal 

The COPY command does not affect memory and leaves your terminal 
at TOPS-20 command level. 
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Related Commands 


APPEND for adding information to a file or 

putting the contents of many files 
into a single file 

RENAME for changing only the specification 

of a file 

SET SPOOLED-OUTPUT-ACTION for changing the setting of the 

S POOLED-OUTPUT-ACT I ON parameter, 
which determines when files copied 
to output devices are processed 


Examples 


!• Make an extra copy of a file in your connected directory. 

B COPY FQRT.TXT BACKUP.TXT 
FORT , TXT . 1 => BACKUP. TXT. 3 [OK] 

B 

2. Copy a file from your directory into another user's 
directory, allowing it to be labeled with default file 
specifications there. 

B ACCESS PARTIN I > 

Passwo r d : 

B COPY TEST 1 . CBL <SARTINI> 

TEST 1 .CBL. 2 => < S ART I N I >TEST 1 . CBL . 2 [OK] 

B END- ACCESS CSARTINI > 

B 

3. Use a wildcard character to copy several files from your 
directory on another structure to magnetic tape. 

B ACCESS SNARK : 

B CDPY SNARK : NA* . TST MT2 : 

SNARK : N ACCESS . TST .2 => MT2 : N ACCESS . TST [OK 
SNARK :NADUISE.TST ,2 => MT2 : NADU I SE . TST [OK] 

SNARK : NAPPEND .TST .2 => MT2 : NAP PEND . TST [OK ] 

SNARK : NASSIGN . TST . 2 => MT2 : N ASS I GN . TST [OK] 

SNARK :NATTACH.TST ,2 => MT2 : NATT ACH . TST [OK] 

B END-ACCESS SNARK : 

B 
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Use the COPY command to create a short text file. 

e CDPY TTY: NEW - F I LE , TXT 
TTY: => NEW-FILE , TXT , 2 

THIS FILE MAS CREATED USING THE COPY COMMAND, 

~7 

@ TYPE NEW-FILE , TXT 

THIS FILE WAS CREATED USING THE COPY COMMAND. 

@ 
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CREATE 


Function 


The CREATE command lets you make files. 


Format 


0CREATE (FILE) /switch (es) filespec 
where 

switches are keywords, chosen from the list below, indicating 
your choice of CREATE command options 

Defaults are shown in the list of switches 

filespec is a specification for the file you want to create 

Default - the last file specification and 
associated switches you gave in a 
CREATE or EDIT command during the 
current terminal session 


Summary of CREATE Command Switches (defaults in boldface) 

/BAK 

/C128 

/C64 

/DECIDE 

/DPY 

/EXPERT 

/INCREMENT:n Default n - 100 

/ISAVE :n 

/LOWER 

/M33 

/M37 

/NOBAK 

/NODECIDE 

/NONSEPARATORS 

/NONUMBER 

/NOVICE 

/NUMBER 

/OLD 

/OPTION:name 

/PLINEStn Default n - 16 

/R 

/READONLY 

/RONLY 

/RUN: filespec Default file type - .EXE 

/ SAVE : n 

/SEPARATORS 

/SEQUENCE 

/ START : n Default n - argument of /INCREMENT switch 

/STEP:n Default n - 100 

/UNSEQUENCE 

/UPPER 

/WINDOW:n Default n - 10 
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CREATE Command Switches 


/BAK 


/C128 

/C64 

/DECIDE 

/DPY 

/EXPERT 

/INCREMENT :n 

/I SAVE :n 

/LOWER 


/M33 

/M37 

/NOBAK 


/NODECIDE 


causes an unedited copy of the file to be saved 
at the end of an editing session under 
specification name.Qyp, where name.typ is the 
file's original specification 

Default 

calls for a 128-character alphabet, allowing 
insertion of control characters in an alternate 
format. See the TQPS-20 EDIT Reference Manual 
for details. 

calls for a 64-character alphabet, disallowing 
use of an alternate format for insertion of 
control characters 

Default 

lets you decide whether to accept or reject each 
change caused by the operation of the S 
(substitute) command of the EDIT program 

has no effect in the current monitor 

tells the EDIT program that you need only 
abbreviated error messages, and fewer warnings 
and reminders 

specifies the value to add to each line number 
of the file to obtain the next line number 
Default n - 100 

instructs the EDIT program to update the backup 
file of specification name.Qyp after every n 
lines you insert 

specifies that all alphabetic characters you 
type should be considered lowercase characters; 
give uppercase characters by preceding the 
corresponding lowercase character with a single 
quotation mark ('). 

has no effect in the current monitor 

has no effect in the current monitor 

prevents an unedited copy of the file from being 
saved at the end of an editing session under 
specification name.Qyp, where name.typ is the 
file's original specification 

ensures the automatic operation of the S 
(substitute) command of the EDIT program 
Default 
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CREATE Command Switches (Cont.) 


/NONSEPARATORS specifies that the characters . (period), $ 



(dollar sign) , and % (percent sign) are ordinary 
textual characters and not field delimiters 
(separators) in the accompanying file 

Default 

/NONUMBER 

suppresses the printing of line numbers with 
each line of a file 

/NOVICE 

tells the EDIT program that you want to see 
complete error messages and all appropriate 
warnings; opposite of /EXPERT switch 

Default 

/NUMBER 

prints a line number for each line of the file 

Default 

/OLD 

causes the first backup file to be saved under 
the specification name.Zyp, where name.typ is 
the file's original specification 

/OPTION :name 

sets any EDIT switches contained in lines of the 
SWITCH.INI file in your log-in directory labeled 
with name (of 6 or fewer characters) . See the 
TOPS-20 EDIT Reference Manual for more 
information about SWITCH.INI files. 

/PLINES :n 

specifies how many lines to print in response 
to each P (print) command of the EDIT program 
Default n - 16 

/R 

same as /READONLY 

/READONLY 

prevents any changes to the file during the 
current session of the EDIT program, i.e., makes 
it a read-only session 

/RONLY 

same as /READONLY 

/RUN : f ilespec 

specifies an executable program to be run when 
you end the current session of the EDIT program 
with the G command 

Default file type - .EXE 

/SAVE :n 

instructs the EDIT program to update the backup 
file (of specification name.Qyp) after every n 
EDIT program commands that modify the file 
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CREATE Command Switches (Cont.) 


/SEPARATORS 

/SEQUENCE 

/START :n 

/STEP : n 
/UNSEQUENCE 

/UPPER 

/WINDOW :n 


notifies the EDIT program that the characters 
(period), $ (dollar sign), and % (percent sign), 
are not ordinary textual characters but are 
field separators in the accompanying file 

tells the EDIT program not to strip the line 
numbers from the file when the EDIT session ends 

Default 

specifies the first line number for the EDIT 
program to use when numbering the file 

Default n - argument of /INCREMENT switch 

same as /INCREMENT 

tells the EDIT program to strip the line numbers 
from the file when the EDIT session ends 

specifies that all alphabetic characters you 
type should be considered uppercase characters; 
give lowercase characters by preceding the 
corresponding uppercase character with a single 
quotation mark (')• 

Default 

specifies the number n (between 10 and 99) of 
pages to be held in memory during the EDIT 
session 

Default n - 10 


Characteristics 


Input Mode and Edit Mode 

The CREATE command runs the EDIT system program, first in 
Input mode and then in Edit mode. (However , see also 
Special Cases, below.) Input mode automatically begins each 
line with a line number (unless you have given the /NONUMBER 
switch), and allows you to put any alphabetic or numeric 
information into the file. When you have finished doing 
this and press the ESCAPE key, the EDIT program puts you 
into Edit mode and prompts you with an asterisk (*), just as 
if you had typed the EDIT command with the specifications of 
the newly-created file as argument. If you want to save the 
file in its present state, give the E (for end) command to 
the EDIT program. Otherwise you can give any other EDIT 
command to change or add to the file before saving it. 
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Hints 


Saving Backup Files Periodically 

Give the /ISAVErn switch to save an updated copy of the file 
you are creating after every n lines inserted. Then you 
will lose only a few lines of input in the event of a system 
failure. The similar /SAVE:n switch is useful for the 
CREATE command only in Edit mode, where it saves an updated 
copy of the file after every n EDIT program commands that 
modify the file. 

SWITCH . INI File 

If there is a group of CREATE command switches that you 
always or often use with CREATE or EDIT commands, put them 
into a file of specification SWITCH.INI in your log-in 
directory, in a line of that file beginning with EDIT : abc , 
where abc is any set of characters you choose to identify 
the line. Then if you include the single switch /OPTION*abc 
when you give a CREATE or EDIT command, all these switches 
will be in effect. 

Further Information 

For more information about the EDIT program, see the TOPS-20 
EDIT Reference Manual. 


Special Cases 


Using an Editor Other than EDIT 

The CREATE and EDIT command descriptions in this manual 
assume that these commands call on the EDIT program for 
their action. If your job uses another editing program 
(e.g., TV, the editor designed especially for use with 
display terminals) , the switches and examples shown here 
will not be applicable. The editor used by CREATE and EDIT 
is specified by logical name EDITOR:, so you can find out 
_ ®_ „? arae of th i s program by giving the command, INFORMATION 
LOGICAL-NAMES EDITOR:. The system-wide definition will be 
given first, followed by the job-wide definition (if any) • 
the job-wide definition prevails if both exist. If the 
definition of EDITOR: is SYS : EDIT . EXE , the CREATE and EDIT 
commands will function as described in this manual. 

Y ° U muSt consult the appropriate manual (e.g., 
th e TOPS-20 TV Editor Manual ) for information. 

US ® fc |j e DEFINE _ command to define logical name 
EDITOR. to be any editing program available at your 
installation. Then this editor will be in effect when you 
give the CREATE or EDIT command. 
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Effect on Memory 

The CREATE command clears memory, then loads the EDIT program 
into memory, and leaves your terminal at command level (Input 
mode) in EDIT. 

Related Commands 


DIRECTORY-class commands for getting lists of existing files 
EDIT for modifying existing files 


Examples 


1. Create a file. 

@ CREATE FILE1 . TXT 

Input : FILE1 .TXT. 1 

0 0 1 0 0 ! THIS IS A SHORT TEXT FILE. 

00200 $ 

*E 

CFILE1 , TXT , U 
@ 

2. Create and edit (using the P and R commands to the EDIT 
system program) another file. 

B CREATE FILEB.TXT 
Input: FILED. TXT. 1 

0 0 1 0 0 ! TH I 5 IS ANOTHER SHORT TEXT FILE. 

0 0 2 0 0 $ 

*p 

0 0100 [THIS IS ANOTHER SHORT TEXT FILE. 

* R 1 0 0 

00100 (THIS IS A SECOND TEXT FILE. 

0 0 2 0 0 $ 

1 Lines (00100/1) deleted 
*P 

00100 ! TH I S IS A SECOND TEXT FILE. 

*E 

[FILEB.TXT. 1 ] 
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3. Create, then execute, a FORTRAN program. 


BCREATE FILEE 

.FOR 


I n put: 

FILEE. 

FOR. 1 


0 0 1 0 0 

C 

THIS ISA SHORT 

TEST PROGRAM. 

0 0 2 0 0 


TYPE 101 


0 0 3 0 0 

101 

FORMAT ( ' THIS 

IS ONLY A FORTRAN TEST 

00400 


END 


00500 

$ 



*E 





) 


C F I LEE , FOR . 1 ] 

6 EXECUTE FILEE.FOR 
FORTRAN: FILEE 
MAIN . 

LINK: Loading 

ILNKXCT FILEE Execution] 


THIS IS ONLY A FORTRAN TEST. 

END OF EXECUTION, 

CPU TIME: 0.04 ELAPSED TIME: 0.44 

EXIT 

B 
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CREF 


Function 


The CREF command runs 
cross-reference listings 


the CREF program, which 
from files of type .CRF. 


produces 


Format 


@CREF destination f ilespec=source filename 

where 

destination filespec is the name of the file or device to 

which you want to send the processed 
contents of the .CRF file 
Default - LPT: 

source filename is the name of the .CRF file you want to 

process 

Default - the names of all files of 
type .CRF produced during 
the current terminal 
session 


Characteristics 


Current .CRF Files 

If you have files of type .CRF produced by LOAD-class 
commands during the current terminal session, the unmodified 
command CREF produces listings of them and deletes the 
files. By supplying an argument of the form shown in the 
Format section above, you can copy the listing for a current 
.CRF file to another file or device. To run the CREF 
program yourself when you have current .CRF files, give the 
command R CREF instead. 

.CRF Files From a Previous Session 

If your only files of type .CRF produced by the .CRF program 
were produced during a previous terminal session, the 
command CREF puts your terminal at command level in the CREF 
program, symbolized by an asterisk (*) . Thus it is 
equivalent to the command R CREF in this case. See 
Hints - Further Information, below, for advice oh how to 
proceed . 


Hints 


Producing .CRF Files 

You can produce cross-reference files by including the /CREF 
switch in any LOAD-class command that actually causes a 
compilation (i.e., is not prevented from doing so by a 
/RELOCATABLE switch or by the existence of current object 
files) . 
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Preserving .CRF Files After Processing 

Give the /P switch immediately after the CREF command to 
preserve .CRF files. Ordinarily they are deleted after 
being sent to an output device or copied into another file. 

Further Information 

For more detailed information about the CREF program, 
including all available switches, give the HELP CREF 
command. See Chapter 8 of the TOPS-20 User Utilities Guide 
for a full description of CREF. 


Effect on Memory and Terminal 


The CREF command replaces the contents of memory with the CREF 
program and leaves your terminal at TOPS-20 command level, or at 
command level within CREF (denoted by an asterisk prompt (*)). 


Related Commands 


LOAD-class commands for producing .CRF files 


Examples 


1. Give the CREF command to obtain a listing of your .CRF file. 
e CREF 

CREF: TESTF1 

@ 

2. Compile two FORTRAN programs, using the /CREF switch to 
produce .CRF files. Then give the CREF command to obtain 
listings of these, and use the /P switch to preserve the .CRF 
files . 

O COMPILE /CREF TE5TF1 .FOR , TESTF2.FDR 

FORTRAN: TESTF1 

MAIN. 

FORTRAN: TESTF2 
MAIN . 

O CREF/P 

CREF: TESTF1 

CREF: TESTF2 

§ 
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3. Determine what . CRF files you have, then mount a tape. Give 
the CREF command, and once within the CREF program, have the 
cross-reference listing produced from one of these files 
copied onto tape. (The .CRF files are not processed 
automatically when you give the CREF command because they 
were produced during a previous terminal session.) 

6 DIRECTORY * . CRF 

PS : < LATTA > 

TESTM1 . CRF . 2 
TESTM2 . CRF . 1 

Total of 2 files 

B MOUNT TAPE CRFM AC : / NR I TE - ENABLED 

[Mount Request C R F M A C Queued > Request-ID 1 2 8 1 

[Tape set C R F M A C i volume C R F M A C mounted] 

[ CRFM AC defined as MT3 : 1 
OCREF 


* MT3 : = TESTM2 
[ CRFXKC a K co rel 
*j^C 

e PISMOUNT TAPE CRFM AC : 

[Tape dismounted > logical nameCRFMAC: deleted] 
@ 
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CSAVE 


Function 


The CSAVE command makes a non-sharable copy of the program in 
memory and stores it in a file, in compressed executable format. 


Format 


@CSAVE (ON FILE) filespec (WORDS FROM) loci (TO) loc2, loc3 loc4,. 


where 

filespec is the file specification under which you 

want to store the program 

Default filespec - program name.EXE 

loci loc2, are pairs of octal numbers or symbolic 

loc3 loc4, expressions that specify the span(s) of 

. . . memory locations you want to save 

Default loci loc2 - 20 to last location 
occupied by program 

Caution 


Inefficiency of CSAVE Compared to SAVE 

The CSAVE command saves in a compressed-f ormatted file 
whatever program the system finds in memory. When the file 
is returned to memory, this format prevents other users from 
sharing the same copy of the file. Therefore you should 
ordinarily use the SAVE commmand instead for storing 
programs in executable format. 

Effect on Memory and Terminal 

The CSAVE command does not affect memory and leaves your terminal 
at TOPS-20 command level. 


Related Commands 


GET for putting a saved file into memory 

LOAD for putting source or output files into memory 

RUN for running executable programs 

SAVE usual command for saving programs in executable format 
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Examples 

1. Save your currently loaded program in compressed executable 
format . 

e CSftUE 

DMN . EKE . 1 Saved 

@ 

2. Mount a magnetic tape set. Then load an ALGOL program and 
save it in three places in executable format: once in a disk 
file under the same filename, again in a disk file under a 
new filename, and once on magnetic tape. 

B MQUNT TftPE TAPBAK: /WRITE-ENABLED 

[Mount Request TAPBAK Queued » Resuest-ID 140] 

[Tape set TAPBAK > volume TAPBAK mounted] 

[TAPBAK defined as MT2 : ] 

@ LQ AD TEST A 1 
LINK: Load in 3 

EXIT 

e CSAPE 

TEST A 1 . EXE . 1 Saved 
B CSAPE BAK 
BAK . EXE . 1 Saved 
@ C S A 0 E MTS : 

MTS : BAK Saved 
@ D 1 5MDUNT TAPE TAPBAK : 

[Tape dismounted t logical name TAPBAK : deleted] 

§ 
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DAYTIME 


Function 


The DAYTIME command prints the current day, date, and time on 
your terminal. 


Format 


0DAYTIME 


Hints 


Using DAYTIME 

The DAYTIME command, which does not require you to be logged 
in, lets you check the system's clock against your own. If 
you are saving the output from a hard-copy terminal, use 
this command to make a record of the date and time. 


Effect on Memory and Terminal 


The DAYTIME command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Examples 


1. Give the DAYTIME command. 
e DAYTIME 

Friday > April 20 » 1979 09:21:19 

@ 
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Function 

The DDT command loads or merges a debugging program into memory 
(unless one is already there) , then starts it. 

Format 

@DDT/swi tch 
where 

/switch is /USE-SECTION : n 

specifies the memory section (from 0 to 37 
octal) into which the debugging program is to 
be loaded, run, or merged 

Characteristics 

If a Debugging Program is Already Loaded 

If you have already loaded a debugging program into memory 
along with your program, the DDT command starts the 
debugging program. 

If Your Program, But Not a Debugging Program, is Already Loaded 

If a program containing symbols is in memory without a 
debugging program, the DDT command merges SYSiUDDT.EXE into 
memory, then starts this debugging program. 

If There is No Current Program 

If you do not have a program in memory, or if your program 
does not contain symbols, the DDT command puts SYS : SDDT . EXE 
into memory and starts it. 

Hints 

Using DDT to Create a Program 

You can use DDT to begin typing instructions directly into 
memory, without first putting it into a file for later 
compilation and loading. Give a RESET' command to clear 
memory, then the DDT command. This will load the 
SYS:SDDT.EXE program. Then you can give commands within 
SDDT to create your own program. When using the SDDT 
program, you can use all the symbols in the system parameter 
file MONSYM . MAC . See the TQPS-20 Monitor Calls Reference 
Manual for more information about MONSYM. MAC. This method 
of writing a program is most useful for testing special 
cases, or for learning to use TOPS-20 monitor calls. 
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Special Cases 

Using COBDDT 

If you put COBDDT into memory along with a COBOL program, 
the DDT command starts the UDDT program, not COBDDT. Use 
the REENTER command to start COBDDT in this case. 


Effect on Memory and Terminal 

The DDT command merges the SYS:UDDT.EXE program into memory and 
starts it, or loads and starts SYS : SDDT . EXE . If you have already 
loaded a debugging program, the DDT command starts this program. 
In each case your terminal is left at command level in the 
debugging program. 

Related Commands 

DEBUG for loading your program along with a particular 

debugging program (e.g., FORDDT or COBDDT) 


Examples 

1. Give the DDT command to begin debugging a program currently 
in memory. 

B DDT 

DDT 

2. Give the DEBUG command to debug a FORTRAN program; type a 
CTRL/C to return to TOPS-20 command level so you can find out 
the current load averages and number of jobs for the system. 
Return to your debugging program (FORDDT in this case) by 
giving the DDT command. 

6 DEBUG TESTF1 

LINK: Loading 

CLNKDEB FORDDT Execution] 

STARTING FORTRAN DDT 

>> JjC 

B SY5TAT SYSTEM 

Fri 2 0 - A p r-79 13:50:01 Up 36:47:55 

35+14 Jobs Load a u (class 0) 0.72 0.81 1.33 
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@ DDT 

STARTING FORTRAN DDT 

>> START 

THIS ISA TEST. 

END DF EXECUTION 

CPU TIME: 0.04 ELAPSED TIME: 0.33 
EXIT 

@ I NFQRMAT I ON MEMORY-USAGE 

SB. p a 3 e s i Entry vector 1 □ c 0 1 e n 254000 
0-12 Private RtW.E 

400 Private R.W.E 

401-4BG < S U B S V S > F 0 R 0 T S . E X E . 3 3-70 R , CW , E 

@ 
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DEASSIGN 


Function 


The DEASSIGN command returns a device previously assigned by you 
back to the pool of available resources. 


Format 


0DEASSIGN (DEVICE) dev: 
where 

dev: is the name of the device you want to deassign; an 

asterisk (*) deassigns all devices (except your 
log-in terminal) assigned to your job. 


Restrictions 


Open Files 

The DEASSIGN command will not deassign a device that is 
accessing an open file. An error is generated, and the 
device is not deassigned until that file is closed or until 
you log out. When you log out, all devices are deassigned. 


Effect on Memory and Terminal 


The DEASSIGN command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


ASSIGN for assigning a particular device 

to your job 

INFORMATION AVAILABLE DEVICES for finding out which devices are 

available, and which ones have 
already been assigned to your job 

MOUNT for mounting a structure or 

magnetic tape and assigning the 
first available disk drive or 
tape drive to your job 
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Examples 


1. Deassign a device (in this case a card reader). 

B DEASSIGN PCDRO ; 

@ 

2. Find out which devices are assigned to your job, 
deassign all of these. Verify that this was done, 
that your terminal, in this case TTY222:, is 
deassigned . ) 

@ INFORMAT I ON AVAILABLE DEUICE5 
DeM ices available to this Job: 

DSK f PS , SNARK t PACK , FTN20 » MTA2 t MTO » LPT , LPTO » LPT1 
CDR . PCDRO » CD P » FE1-15 , PTY15-61 * NUL , PLT , PLTO » DCN 
SRO 

Devices assigned to/ opened by this Job: M T A 2 » MTO t PCDRO 
TTY222 t PTY15 
B DEAS5IGN * 

@ I NFDRMAT I ON A MAILABLE DEVICES 
Devices available to this Job: 

DSK » PS , SNARK » PACK » FNT20 » MTA2 » LPT , LPTO » LPT1 
CDR , PCDRO » CDP , FE1-15 » PTY15-61 , NUL , PLT , PLTO 
DCN » SRM 

Devices ass i Sued to/ope ned by this Job: T T Y 2 2 2 
0 


then 

(Note 

never 
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Function 

The DEBUG command loads your program into memory along with a 
debugging program, compiling the source file first if necessary. 
Then it starts the debugging program. 

Format 


0DEBUG (FROM) /switch (es) source/switch (es) object,... 

where 

switches are keywords chosen from the list below, 

indicating your choice of DEBUG command options. 
They have different effects depending on their 
position in the command line: placed before all 
files in the command, they act as defaults for 
all; otherwise, they affect only the nearest 
preceding file. 

Defaults are shown in the list of switches 

source is the file specification of the source program. 

The filename must be of 6 or fewer characters, and 
the file type of 3 or fewer characters; you 
cannot use a generation number. This argument is 
not necessary if you supply an object filespec. 

object is the file specification of the object program. 

The filename must be of six or fewer characters, 
and the file type must be .REL; you cannot use a 
generation number. This argument is not necessary 
if you supply a source filespec. 

Default (if you give neither source nor 
object filespecs) - last filespecs 
and associated switches you gave in a 
LOAD-class command 

, • • . means that, after commas, you can give more 

arguments (source, switches, and object) of the 
form already shown 

Summary of DEBUG Command Switches (defaults in boldface) 

/ 68-COBOL 

/74-COBOL 

/ALGOL 

/COBOL 

/COMPILE 

/CREF 

/DDT 

/DEBUG 

/FORTRAN 

/LANGUAGE-SWITCHES: "/switch (es) " 

/LIBRARY 

/LIST 

/MACRO 
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/MAP 

/NOCOMPILE 

/NODEBUG 

/NOLIBRARY 

/NOLIST 

/NOOPTIMIZE 

/NOSEARCH 

/OPTIMIZE 

/RELOCATABLE 

/SEARCH 

/STAY 

/SYMBOLS 


Descriptions of these switches are given below. Although the 
system will not reject switches described under any of the 
LOAD-class commands, only those switches commonly associated with 
DEBUG are described here. 


DEBUG Command Switches 


/ 68-COBOL 

/74-COBOL 

/ALGOL 

/COBOL 

/COMPILE 


/CREF 


/DDT 

/DEBUG 


/FORTRAN 


compiles the file using the COBOL-68 compiler 
Default for files of type .CBL 

compiles the file using the COBOL-74 compiler 

compiles the file using the ALGOL compiler 

compiles the file using the COBOL-68 compiler 

forces compilation of the source file even if a 
current object file already exists. Use this 
switch along with a /LIST or /CREF switch to 
obtain listings when you have current object 
files . 

creates a file containing cross-reference 
information for each compilation. The filename 
is that of the object file; the file type is 
. CRF . Use the CREF command to obtain a listing 
of the file. (For COBOL files, this switch 
automatically produces a cross-reference 
listing.) See the TQPS-20 User Utilities Guide 
for more information about the CREF program. 

loads the DDT debugging program along with your 
object file 

produces an object file containing debugging 
information beyond what is usually inserted 
during compilation. (For FORTRAN programs only, 
and only if you have not given the /OPTIMIZE 
switch. ) 

compiles the file using the FORTRAN compiler 

Default for switches specifying a 
compiler language, in the 


TOPS-20 Version 5 


86 


April 1982 



DEBUG (Cont.) 


DEBUG Command Switches (Cont.) 


/LANGUAGE-SWITCHES: "/switch (es) " 

passes the specified switches to 
that will process the file(s) 
switch applies. You must include 
in double quotation marks (" "). 


the compiler 
to which this 
the switches 


/LIBRARY 

/LIST' 


/MACRO 

/MAP 


/NOCOMPILE 


/NODEBUG 

/NOLIBRARY 

/NOLIST 

/NOOPTIMIZE 

/NOSEARCH 


/OPTIMIZE 


same as /SEARCH 

prints a line printer listing of the program in 
ASCII format; the name of this listing is the 
filename of the object file. The /CREf" switch 
overrides /LIST when they both apply to the same 
f ile . 

assembles the files using the MACRO assembler 

produces a loader map and stores it in the file 
object. MAP, where object is the name of the 
module containing the start address; or (if no 
start address) nnnLNK . MAP , where nnn is your job 
number . 

prevents compilation if the associated object 

file is current; otherwise it forces 
compilation. Use this switch to cancel a 
/COMPILE or /RELOCATABLE switch. 

Default 

excludes special debugging information from your 
object file. (For FORTRAN programs only.) 

same as /NOSEARCH 

prevents a line printer listing of the program 
Default 

prevents the generation of a globally optimized 
object file. (For FORTRAN programs only.) 
Default 

requires all modules in the object file library 
(the file accompanied by this switch in the 
command line) to be loaded even if they are not 
called by your program. Use this switch to 
cancel a /SEARCH switch. 

Default 

calls for generation of a globally optimized 
object file, i.e., one that runs as quickly as 
possible. (For FORTRAN programs only, and only 
if you do not also give the /DEBUG switch.) 
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DEBUG Command Switches (Cont.) 


/RELOCATABLE 


/SEARCH 


/STAY 


/SYMBOLS 


prevents compilation of the source file, forcing 
use of an existing object file even if the 
object file is out of date 

requires that the object file library (the file 
accompanied by this switch in the command line) 
be searched for modules called by your program 
or by a program subroutine. Only these modules 
are loaded, along with modules called from the 
system libraries, which are always searched. 

returns your terminal to TOPS-20 command level 
so that you can perform other work while the 
system continues executing the DEBUG command. 
You immediately receive the TOPS-20 prompt (@ or 
$) and can then issue any user command. But be 
careful with commands that run programs, because 
those commands may clear memory and terminate 
the current process. Also, you could easily 
send incorrect data to programs expecting 
terminal input. This switch saves you from 
having to: issue a ~T to make sure the debugger 
has begun; give a ~C to halt debugging; and 
issue a CONTINUE STAY command to remain at 
command level during debugging. 

loads a symbol table along with the object file; 
helpful for debugging a program. 

Default 


Characteristics 

Compiling New Sources Only 

Before debugging programs, the system ordinarily compiles 
any source (and only those sources) whose write date is more 
recent than that of the object file of the same name. You 
can override this action with the /COMPILE or /RELOCATABLE 
switch. Note that the DDT debugging program is used when 
/RELOCATABLE prevents a new compilation. 
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Using Standard File Types 

If you specify source files with standard types (.FOR, .MAC, 
. CBL , or. ALG) in a DEBUG command, the system automatically 
calls the appropriate compiler when compilation is 
necessary. If you specify source files by filename only, 
the system searches your connected directory in the above 
order for a file of this name and a standard type. To debug 
programs from sources that have nonstandard file types, give 
a switch to indicate the proper compiler (/FORTRAN, /MACRO, 
/COBOL, or /ALGOL) . A switch will take precedence over a 
standard file type if they indicate different languages. If 
no compiler is indicated with either a switch or a standard 
file type, the FORTRAN compiler is used. 

Name of Debugging Program Loaded by DEBUG 

Ordinarily the DEBUG command causes the appropriate 
debugging program to be loaded along with your program 
( FORDDT with FORTRAN programs. COBDDT with COBOL programs, 
DDT with MACRO and ALGOL programs) . Use the /DDT switch to 
specify that DDT be used. 


Hints 


Commas Between Filespecs 

If you give two or more filespecs separated by commas as 
arguments to DEBUG, the loaded programs exist in memory at 
the same time and will act as a single program. You can use 
this feature to substitute one module for another under 
varying conditions or for different applications. 

Plus Signs Between Filespecs 

If you give two or more filespecs separated by plus signs 
(+) as arguments to DEBUG, they are treated as a single file 
by compilers. Their object module is stored under any 
filename given as the "object" argument of the command, or 
(if none) under the last filename in the group and file type 
.REL. 


Indirect Files as Arguments 

You can store the arguments (source and object filespecs, 
switches) of a DEBUG command in an indirect file, and 
specify them by typing an at sign (@) and its filespec as a 
DEBUG command argument. 

Establishing Default Arguments with the SET Command 

You can issue the SET DEFAULT COMPILE-SWITCHES command to 
set up default global arguments to the DEBUG command. 
Insert this SET command in your COMAND.CMD file to change 
your own defaults permanently. 
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Including all FORTRAN Debugging Information 

If you are debugging a FORTRAN program and you wish to 
examine line numbers or DO loops, or use statement tracing 
or array dimension checking, give the /DEBUG and /COMPILE 
switches with the DEBUG command to include the necessary 
information . 


Running LINK Directly 

The DEBUG command automatically runs LINK, the system's 
loader program, but if you require control of the loading 
process you can run LINK directly. See the TQPS-20 LINK 
Reference Manual. 


Restrictions 


Switches Requiring Compilation 

/CREF 

/DEBUG 

/LANGUAGE-SWITCHES 

/LIST 

/NODEBUG 

/NOLIST 

/NOOPTIMIZE 

/OPTIMIZE 

The above switches will not take effect unless the DEBUG 
command causes a new compilation of the relevant source 
file. See Characteristics - Compiling New Sources Only, 
above, for more information. 


Effect on Memory and Terminal 


The DEBUG command clears memory, loads the appropriate compiler 
if necessary, then loads your program and a compatible debugging 
program. It leaves your terminal at program command level within 
the debugging program. 


Related Commands 

COMPILE, LOAD, and EXECUTE other LOAD-class commands for 

performing related functions 

DDT 1 tor loading and starting the DDT 

debugging program, or for starting 
the debugging program you have 
already loaded 
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Examples 

1. Debug a FORTRAN program. 

B DEBUG FORT , FOR 
FORTRAN: FORT 
MAIN. 

LINK: LOADING 

C LNK DEB FORDDT EXECUTION] 
STARTING FORTRAN DDT 


2. Debug an optimized FORTRAN program, although there is a 
current (but not optimized) object file. 

B DEBUG /QPTIMIZE/FORTRAN/COMPILE FORT 

FORTRAN: FORT 
MAIN . 

LINK: LOADING 

CLNKDEB FORDDT EXECUTION] 

STARTING FORTRAN DDT 
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3. Using incompatible switches, try to debug a 
system ignores one of them and continues.) 

6 DEBUG /CQMPILE/QPTIMIZE/DEBUG FORT 
FORTRAN: FORT 

ZFTNNOD GLOBAL OPTIMIZATION NOT SUPPORTED WITH 
/DEBUG - /OPT IGNORED 
MAIN . 

LINK: LOADING 

ELNKDEB FORDDT EXECUTION] 

STARTING FORTRAN DDT 


4. Get a time-ordered list of TEST1 files in 
Debug an old version of it. 

B TDIRECTQRY TEST 1 . * 

WRITE 


P S : < L A T T A > 

TEST1.CBL.2 5 - A PR - 78 1 3 : 1 0 : 57 

.LST.i 6-0CT-77 14:22:00 

.REL.l G-OCT-77 10:08: 17 

TOTAL OF 3 FILES 
S DEBUG TESTI/RELOCATABLE 
LINK: LOADING 

ILNKDEB DDT EXECUTION] 

DDT 


program. (The 


your directory. 
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DEFINE 


Function 


The DEFINE command establishes or withdraws logical names for 
your job. 


Format 


0DEFINE (LOGICAL NAME) name: list 
where 

name: is any combination of up to 39 alphanumeric 

characters followed by a colon, that you want to use 
as a logical name. Use an asterisk (*) for this 
argument to withdraw all logical names. 

list is a series of devices, file structures, 

directories, file specifications, and/or other 
logical names; each item should be separated from 
the others by commas. 

Default - not specifying a list withdraws the 
logical name definition 


Hints 


DEFINE in LOGIN.CMD File 

Your DEFINE command is valid for the current terminal 
session only. If there are logical names that you always 
want to use, put DEFINE commands into a LOGIN.CMD (or, for 
batch jobs started by SUBMIT commands within the control 
files of other batch jobs, a BATCH.CMD) file in your log-in 
directory. 

Redefining System Logical Names 

You can use the DEFINE command to redefine any system 
logical name for your own job. By repeating a system 
logical name in its own search list you expand its 
definition to include the other items, in the order you 
specify. Consider the system logical name SYS:, which is 
searched whenever you give a program name in place of a 
TOPS-20 command. If you redefine SYS: to be 
str : <directory> , SYS: you can run programs in 
str : <directory> by typing just their names. This will work 
as long as the program names are not the same as TOPS-20 
commands . 


Logical Names as Dummy Filespecs 

You can use logical names as dummies for filespecs or 
devices when writing programs. Then, just before running 
such a program, use the DEFINE command to define these as 
real filespecs or devices, without changing the program 
itself . 
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More Information 

For more information about using logical names, see the 
TOPS-20 User's Guide. 


Restriction 


Using Short Logical Names Only 

Although logical names can be up to 39 characters long and 
can include dollar signs ($) , hyphens (-) , and underlines 
(_) , some commands and programs (e.g., programs originally 
written for the TOPS-IO operating system) accept a more 
limited set of logical names. These can be no more than 6 
characters long and cannot include any special symbols. If 
all your logical names are of this kind, they will be 
acceptable to any TOPS-20 programs and commands. 


Effect on Memory and Terminal 

The DEFINE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 

INFORMATION LOGICAL-NAMES for finding out the current 

definitions of logical names 


Examples 


1. Define a logical name for your job. 

e DEFINE LGN ; <MANUftLS> > < S ft R T I N I > 

@ 

2. Withdraw the logical name. 

B DEFINE LGN: 

@ 

3. Define a logical name to be a set of directories to which you 
have access. Then use the logical name to copy a file from 
one of them into your connected directory. 

B DEFINE MSM : < MANUALS > > < 5 ft R T I N I > , < M C E L hi □ Y L E > 

B COPY MSM : 4-UPED . TXT 

< M C E L M 0 Y L E > 4 - U P E D . T X T . 1 = > 4-UPED . TXT . 1 [OK] 

B 


93 



DELETE 


Function 


The DELETE command marks one or more files for eventual erasure. 


Format 


^DELETE (FILES) f ilespec , . . . , 
@@subcommand 

where 

f ilespec 




subcommand 


is the specification of a file that 
you want to delete 

Default .gen - all generations 
of the 

specified files 

means that after commas you can 
give more file specifications 

means that after a final comma you 
can give subcommands on the next 
line 

is a keyword, chosen from the list 
below, indicating your choice of 
DELETE command options 


DELETE Command Subcommands 


ARCHIVE 


CONTENTS-ONLY 


DIRECTORY 


EXPUNGE 


both deletes the disk copy (if any) 
and gives up the tape copy of 
specified archived files 

deletes and immediately expunges 
only the disk copy of files that 
also have a tape copy. Note that 
you must use the RETRIEVE command , 
not UNDELETE, to restore such files 
to disk. 

deletes and immediately expunges 
directory files without making 
their disk space available to the 
files of other users; for users 
with enabled Wheel or Operator 
capabilities only. 

immediately and permanently erases 
the specified files from the 
directory 
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DELETE Command Subcommands (Cont.) 


FORGET deletes and immediately expunges 

the specified files without making 
their disk space available to the 
files of other users; for users 
with enabled Wheel or Operator 
capabilities only. 

KEEP n saves the n most recent generations 

of the specified files while 
deleting the rest 
Default n - 1 


Output 


Whenever an archived file is completely expunged as a result of 
your DELETE command (i.e., when you also give the . ARCHIVE 
subcommand) , the operator sends a MAIL message notifying the 
owner of the directory from which the file was taken. For this 
purpose, the owner of the directory is defined to be the user or 
users whose user names appear in a file of specification 
DIRECTORY. OWNER in the directory. If this file does not exist, 
the message is sent to MAIL.TXT in the directory. If neither 
file exists, no message is sent. 


Characteristics 


Privileged Subcommands to DELETE 

The DIRECTORY and FORGET subcommands to the DELETE command 
are intended for privileged users only, and only as a last 
resort, because they withhold freed disk space from system 
use. Users with enabled Wheel or Operator capabilities can 
run the CHECKD program to recover this disk space. 
DIRECTORY should not be used unless the KILL subcommand to a 
BUILD command fails to delete the directory. FORGET is for 
removing damaged files from directories, and should not be 
used unless DELETE without subcommands fails to delete the 
file . 


Hints 


Removing Open Files 

If DELETE with the EXPUNGE subcommand fails to erase a file, 
it may be that some job in the system has opened it. The 
INFORMATION FILE-STATUS command tells whether your own job 
has done so. If it has, give the CLOSE or (if the file is 
mapped) RESET command before repeating DELETE and EXPUNGE. 


95 



DELETE (Cont.) 


Recovering Deleted Archived Files 

If you have given the DELETE command with the ARCHIVE 
subcommand to delete an archived file, and the disk copy has 
already been expunged, you may still be able to recover the 
tape copy. The operator will send a MAIL message (see 
Output, above) concerning the discarded tape copy of the 
deleted file. Use this information, along with 
Hints - Undoing DISCARD, in the DISCARD command description, 
to attempt recovery of the deleted file. 


Special Cases 


Files With the "Permanent" Attribute 

The system erases only the contents of any files that have 
the Permanent attribute (e.g., MAIL . TXT in your log-in 
directory) when you include them in a DELETE command. Their 
file specifications remain among your deleted files, and 
cannot be removed by TOPS-20 commands. 


Restr iction 


Using Logical Names When Specifying Files for Deletion 

If you include a logical name when specifying arguments to a 
DELETE command, the system will search for the specified 
file in only the first directory of the logical name's 
definition. This restriction prevents the accidental 
deletion of another file if the file you intended to delete 
has already been deleted. 


Warning 


Erasure of Deleted Files 

Ordinarily an UNDELETE command given during the same 
terminal session as an original deletion will recover the 
deleted files, unless you included the EXPUNGE subcommand to 
DELETE or gave a subsequent EXPUNGE command. However, if 
any user or a batch job logs out while connected to your 
directory, all deleted files are permanently erased. Also, 
if available disk space is low on the system, the operator 
or the system itself may expunge all deleted files from 
structure PS: even though you have not logged out. A 
warning message is usually sent before this happens. 


Effect on Memory and Terminal 


The DELETE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 
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Related Commands 


DIRECTORY-class commands 

for obtaining 

specifications 

lists of 

file 

DISCARD 

for deleting only 
on-line files 

the tape 

copy of 

EXPUNGE 

for permanently 
files 

removing 

deleted 

INFORMATION DISK-USAGE 

for finding out how much disk space 
is available, and how much is 


associated with deleted files 
UNDELETE for recovering deleted files 


Examples 


1. Delete two of your files. 

B DELETE TTY . SCM > UERCBL . BAT 
TTY.SCM. 1 [OK] 

UERCBL. BAT. 2 [OK] 

B 

2. Delete all your object files and all your backup files 
produced by the EDIT program. Then log out (this will 
expunge them) . 

B DELETE * . REL > * . Q* 

TEST A 1 .REL. 1 [OK] 

TESTF1 .REL. 1 [ OK ] 

TESTC1 .QBL.2 [OKI 
TESTF1 . QOR . A [OKI 
B LDGOUT 

Killed Job 32 t User J . L . PAGE » Account 341 t TTY 41 
at 25- Apr-78 10: 15:51 » Used 0:1:46 in 1:23:53 
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3. Delete some files, and check what files are currently deleted 
in your connected directory. Give the UNDELETE command for 
two of these, then expunge the remaining deleted files and 
verify that they are gone. 

B DELETE * . QXT 
4-UPED.QXT .7 [OK] 

MAIL. QXT. 1 [OKI 
REMARK , QXT ,3 [OK ] 

@ D I RECTORY , 

BB DELETED 

@@ 

PS : < J » L . PAGE > 

4-UPED . QXT. 1 ,2 ,3 ,4 ,5 »G ,7 
.TXT. 7 ,8,9 
MAIL . QXT . 1 
MEMO . QMD , 1 
REMARK . QXT .1 ,2,3 
TTY . SOM . 1 
UERCBL.BAT. 2 

Total of 17 f i les 
BUNPELETE TTY . SCM , VERCBL . BAT 
TTY. SOM. 1 [OKI 
VERCBL.BAT. 2 [OK] 

B EXPUNGE 

PSs< J,L.PAGE> [8 p a ? e s freed] 

B P I RECTORY , 

BB DELETED 

@@ 

@ 


98 



DEPOSIT 


Function 

The DEPOSIT command modifies the contents of a specific memory 
location . 

Forma t 

^DEPOSIT (MEMORY LOCATION) address ( CONTENTS ) data 
where 

address is an octal number or a symbol 

data is a symbolic or numerical expression 

Output 

Status of Pages 

When you complete a DEPOSIT command, the system gives you a 
message indicating the status of the page you are trying to 
change: "[New]" for previously nonexistent pages, 

"[Shared]" for those having Copy-on-Write status, or "?Can't 
write that page" for other pages. (See also Hints - Setting 
the Page-access of Memory Pages, below.) However, no 
message is printed for deposits made to private pages. 


Hints 


Using Symbols 

For symbols that are defined in multiple modules of a 
program, you can be specific by giving the module name 
followed by an ampersand (&) and the symbol name. 

Using DDT Instead 

Usually the DEPOSIT command is unnecessary, as the DDT 
program provides more powerful methods for modifying the 
contents of memory. 

Abbreviating DEPOSIT Arguments 

The contents of each memory location are represented as two 
6-digit octal numbers. By inserting a pair of commas 
between these two numbers, you can abbreviate them. For 
example, to deposit 000004000050 into memory location 
151003, use the command 

^DEPOSIT 151003 4 , , 50 

This is the same as 

(^DEPOSIT 151003 4000050 

Note that you can also insert commas between expressions. 
For example, the command 

^DEPOSIT 1 1 + 3 , , 5 + 7 
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deposits 000004000014 into memory location 1. (Expressions 
are considered to be octal unless they contain an 8 or a 9, 
in which case they are considered to be decimal and are 
translated to octal.) 

The DEPOSIT command itself can be abbreviated by the single 
letter D. 

Deposit Address Defaults to the One Examined, and Vice Versa 

The first argument of a DEPOSIT command defaults to the 
address examined by your most recent EXAMINE command. (You 
must press the ESCAPE key to take this default.) The 
argument of an EXAMINE command defaults to the address whose 
contents were modified by your most recent DEPOSIT command. 
Therefore you can examine a memory location, deposit a new 
value in it, and verify your action, while specifying the 
location only once. If you give DEPOSIT commands without 
intervening EXAMINE commands (or vice versa) , the default 
address increases by 1 for each subsequent command. 

Setting the Page-access of Memory Pages 

If the system responds to a DEPOSIT command with an error 
message of the form, "?Can't write that page", give the SET 
PAGE-ACCESS COPY-ON-WRITE command for the page. Then give 
DEPOSIT again. If the system allows it, you will be given 
your own copy of the page to modify. 

Using DEPOSIT With Inferior Processes 

To modify memory for a process inferior to the one 
immediately below the TOPS-20 command processor, you must 
give the FORK command to specify this process before using 
DEPOSIT. Remember that for an inferior process to run, all 
superior processes must be running too. INFORMATION 
PROGRAM-STATUS tells you which processes these are. 

Effect on Memory and Terminal 

The DEPOSIT command changes one location in memory and leaves 
your terminal at TOPS-20 command level. 

Related Commands 


DDT for calling a debugging program, 

allowing more efficient modification 
of memory 

EXAMINE for displaying the contents of a 

specific memory location 
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FORK for selecting the process whose 

memory you want to modify 

INFORMATION MEMORY-USAGE for displaying a list of memory 

pages, their contents and status 

SET PAGE-ACCESS for making it possible to write to 

specified pages 

Examples 


1. Deposit a value in a memory location. 

B DEPOSIT 1500 21 
@ 

2. Modify a memory location, using symbols. Then examine the 
location . 

B DEPOSIT (MEMORY LOCATION) T3+1 (contents) P + 2 
B EXAMINE (MEMORY LOCATION) T3+1 
T3+ 1 / P + 2 (A/ 21 ) 

B 

3. Try to deposit a number into a page of memory that does not 
allow it. Examine memory, set the page to Copy-on-Write 
status, and try again (succeeding this time). 

B DEPOSIT 7 1 B 5 0 5 0 
?Can't write that ease 
B I NFORMAT I ON MEMORY-USAGE 

216. p a i e s t Entry vector 1 o c 4 G 2 2 0 7 1 e n 2 5 A 0 0 0 

0-11 Private R i W t E 

20 Private R i W > E 

400-401 Private R > 14 i E 

402-660 <FIELD-IMAGE> F0RTRA.EXE. 3 13-271 R . CW , E 

700-730 <NEXT-RELEASE> PA1050.EXE. 4 1-31 R, E 

731-733 Private R » Wt E 

B SET PAGE-ACCESS 71S C 0 P Y - 0 N - NR I T E 
B DEPOSIT 716505 0 
[Shared! 

B EXAMINE 7 1 G 5 0 5 
716505/ 0 

B 
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4. Check your program status (the arrow (=>) indicates your 
current process (fork)). Select an inferior process, deposit 
a value into a memory location, and verify that memory for 
the superior process is not changed to this. 

0 I NFORMAT ION PROGRAM - STATUS 
Used 0 : 0 0 : 0 5 in 0:10:11 
T 0 P S - 2 0 : 0 : 0 0 : 0 3 . 5 
SET UU0-SIMULATI0N (FDR PROGRAM) 

SET CONTROL-C-CAPABILITY (OF PROGRAM) 

- y Fork 1 : HALT a t 1 G 1 7 S * 0:00:00*3 

Fork 2 : HALT at 472052 , 0 : 00 : 00 . 1 
B FQRK 2 

0 DEPOSIT 3500 12 
B EX AMINE 3500 
3500/ 12 

B FORK 1 

B EXAMINE 3500 

3500/ 202200 >tl 136 

0 
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Function 


The DETACH command disengages your current job from your 
terminal . 


Format 


0DETACH (AND) argument 
where 

argument can be one of these: 

CONTINUE - directs the current program 
to proceed, just as if you 
had typed the CONTINUE 
command 

REENTER - reenters the current program, 
just as if you had typed the 
REENTER command 

START - starts the current program, 
just as if you had typed the 
START command 

Defaulting "argument" leaves the 
program in its present state 
(usually suspended) 


Characteristics 


Effects of Detached Jobs 

Detached jobs use scarce system resources (e.g., swapping 
space, process slots, job slots) and can prevent new users 
from logging in. 

Warning 


Programs Writing to the Controlling Terminal (Device TTY:) 

If a program running in a detached job attempts to write to 
device TTY:, the job will wait until it is again attached to 
a terminal . 


Effect on Memory, Job, and Terminal 


The DETACH command affects your job according to the argument you 
select, and leaves your terminal disengaged from the system in 
the state before log-in. It does not affect memory for the 
detached job. 
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Related Commands 




ATTACH 

for 

joining 

a detached 

SYSTAT 

for 

find ing 

out which ji 

SUBMIT 

for 

running 

independent 

UNATTACH 

for 

disengaging another 


Examples 


1. Detach your job. 

B DETACH 

DetachinS Job # IB 

2. Detach your job while starting the program in memory, then 
log in again. 

B DETACH START 
Detaching Job # 45 

SYSTEM 2102 DEOELDPMENT SYSTEM » TDPS-20 Monitor 4(3212) 

B LOG I N LATTA 341 

Job 5B on TTY222 2G-0ct-79 14:55:03 
B 

3. Log in and put a program in memory; detach the job while 
starting this program, and repeat the entire procedure. Log 
in a third time and begin execution of a third program. 
Interrupt this execution with CTRL/C, then detach this third 
job while continuing its program. Now you have three jobs 
running at once. Instead of logging in again, attach the 
first job (specifying the job number) and verify the system's 
action . 

B LOGIN LATTA 341 

Job 5 on TTY230 2G-0ct-79 14:38:09 

B GET DMN 
B DETACH START 
Detaching Job » 5 

SYSTEM 2102 DEVELOPMENT SYSTEM » T0PS-20 Monitor 4(3212) 

B LOGIN LATTA 341 

Job 22 on TTY222 2G-0ct-79 14:42:03 

B GET TEST A 1 
B DETACH START 
Detachinsf Job # 22 
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SYSTEM 2102 DEVELOPMENT SYSTEM , T0PS-20 Monitor 4(3212) 
B LOG I N LATTA 341 

Job 53 on TTY222 2G-0ct-79 14:44:02 

S EXECUTE TESTF1 
FORTRAN: TESTF1 
MAIN . 

LINK: Loading 

ELNKXCT TESTF1 Execution! 

_C 

B DETACH CONTINUE 
Detaching Job *t 53 

SYSTEM 2102 DEVELOPMENT SYSTEM , T0PS-20 Monitor 4(3212) 
B ATTACH LATTA 

?Job # required - LATTA has mare than one detached Job 
B ATTACH LATTA 5 
P a s s w o r d : 

EXIT 

B I NFQRMAT I ON JOB 

Job 5 i User LATTA » Account 341 > TTY222 
6 SYSTAT LATTA 


5* 

999 

EXEC 

LATTA 

<7 7 

DET 

TEST A 1 

LATTA 

53 

DET 

TESTF1 

LATTA 


B 
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Function 


The DIRECTORY command prints information about the files in a 
d i rectory . 


Format 


^DIRECTORY (OF FILES) f ilespec , 
@@ subcommand 

@< 3 . 


where 
f ilespec 




is the specification of a file about 
which you want information 

Default - *.*.* in your connected 
directory 

means that, after commas, you can give 
more arguments of the kind already shown 

means that, after a final comma, you can 
give one or more subcommands on 
successive lines 


subcommand is a keyword, chosen from the list 

below, indicating your choice of 
DIRECTORY command options 

Defaults are shown in the list of 
subcommands 


Summary of DIRECTORY Command Subcommands (defaults in boldface) 


ACCOUNT 

ALPHABETICALLY 

ARCHIVED 

BEFORE date and/or time 


CHECKSUM 


CHRONOLOGICAL 


( BY-PAGES 
\ SEQUENTIALLY 


WRITE 

CREATION 

READ 

TAPE-WRITE 


CRAM 
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DATES 


I WRITE 

CREATION 

OFFLINE-EXPIRATION 
ONLINE-EXPI RATION 
READ 

TAPE-WRITE 


DELETED 

DOUBLESPACE 

EVERYTHING 

FIND number of generations Default number - 1 

GENERATION-RETENTION-COUNT 

HEADING 

INVISIBLE 

LARGER number of pages 

LENGTH 

LPT 


NO 


ACCOUNT 

CHECKSUM 

CRAM 

DATES 

DOUBLESPACE 

FILE-LINES 

GENERATION-RETENTION-COUNT 
HEADING 
< LENGTH 
LPT 

PROTECTION 

REVERSE 

SEPARATE 

SIZE 

SUMMARY-LINES 
TIMES 
k USER 


OFFLINE 

ONLINE 

OUTPUT filespec Default filespec - DIR. DIR 

PROHIBIT-MIGRATION 

PROTECTION 

RESIST-MIGRATION 

REVERSE 

SEPARATE 

SINCE date and/or time 
SIZE 

SMALLER number of pages 

I WRITE 
CREATION 

OFFLINE-EXPIRATION 

ONLINE-EXPIRATION 

READ 

TAPE-WRITE 

USER i WROTE 

\ CREATED 
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DIRECTORY Command Subcommands 


ACCOUNT 


ALPHABETICALLY 


ARCHIVED 


BEFORE date and time or 
day of week (or 
TODAY) and time 

( SEQUENTIALLY 
CHECKSUM ( BY-PAGES 


CHRONOLOGICAL 


CREATION 

WRITE 

READ 

TAPE-WRITE 


CRAM 


prints the account to which 
storage fees for the files are 
charged 

lists the files in alphabetical 
order 

Default 

restricts the listing to archived 
files only, visible and invisible, 
offline and online 

restricts listing to files last 
written before the date and time 
given 


computes and prints 6-digit octal 
checksums for the files, either 

sequentially and without going 
beyond the EOF (end-of-f ile) 
mark, or 

by pages on disk, accounting 
for holes in files and pages 
beyond the EOF mark; output 
will be followed by letter P in 
this case. 

Default - BY-PAGES 


lists files in order (oldest 
first) according to 


© date of creation, or 
• date they were last changed, or 
® date they were last read, or 
© date their tape copy was 
created , 

Default - WRITE 

compresses formats to reduce 
printing space and time 
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DIRECTORY Command Subcommands (Cont.) 


DATES 


CREATION 

WRITE 

READ 

TAPE-WRITE 

OFFLINE-EXPIRATION 

ONLINE-EXPIRATION 


DELETED 


DOUBLESPACE 


EVERYTHING- 


FIND n 


GENERATION-RETENTION-COUNT 


HEADING 


INVISIBLE 


LARGER n 

LENGTH 


lists for the specified files, the 

® date of creation, or 
® date they were last changed, or 
e date they were last read, or 
e date the tape copy was created, 
or 

® date of expiration 

Default - WRITE 

limits descriptions to deleted 
files that have not yet been 
expunged 

double-spaces the DIRECTORY 

command output 

prints, in this order, the 
following information about the 
files - file specification; 

protection; account number; size 
in pages and in bytes (and 
associated byte size) ; generation 
retention count; date and time of 
creation, of last change (Write), 
last time read, and of the 
creation of any tape copy; the 
name of the user who created the 
file, and of the user who last 
wrote in the file. 

prints the specifications of all 
but the n most recent generations 
of the files, omitting any files 
having n or fewer generations 
Default n - 1 

tells the number of generations of 
each file the system will retain 
in the given directory 

prints a headline labeling each 
category of information supplied 
by the command 
Default 

restricts the listing to invisible 
files only, both on-line and 
off-line 

lists only files of size greater 
than n pages 

gives the file length in bytes and 
the associated byte size 
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DIRECTORY (Cont.) 


DIRECTORY Command Subcommands 


LPT 


directs the command output to LPT: 
instead of to your terminal 


NO < 


ACCOUNT 

CHECKSUM 

CRAM 

DATES 

DOUBLESPACE 

FILE-LINES 

GENERATION-RETENTION-COUNT 
HEADING 
LENGTH 
LPT 

PROTECTION 
REVERSE 
SEPARATE 
SIZE 

SUMMARY-LINES 
TIMES 
USER 


OFFLINE 


ONLINE 


OUTPUT filespec 


PROHIBIT-MIGRATION 


PROTECTION 


RESIST-MIGRATION 


suppresses the action or 
information associated with the 
specified subcommand. (FILE- 
LINES refers to the information 
pertaining to the individual 
files, which is the bulk of 
the DIRECTORY command output. 
SUMMARY-LINES refers to the 
information following the file 
lines, giving a total file-count, 
and total page-count and total 
checksum if required by 
subcommands . ) 

Default - HEADING 

restricts the listing to (visible) 
off-line files only, both archived 
and not archived 

restricts the listing to on-line 
files 

directs the command output to the 
specified file rather than to your 
terminal 

Default filespec - DIR. DIR 

restricts the listing to files 
that are never migrated, because 
they were specified in a SET FILE 
PROHIBIT command 

prints the protection code 
(protection number) of the file 

restricts the listing to files 
that the system considers last for 
migration. These files were 
specified in a SET FILE RESIST 
command . 


REVERSE 


causes an ordering subcommand, 
such as ALPHABETICALLY or 
CHRONOLOGICAL, to arrange its 
output in reverse 
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DIRECTORY Command Subcommands (Cont.) 


SEPARATE 


SINCE date and time or 
day of week (or 
TODAY) and time 

SIZE 


SMALLER n 


TIMES 


CREATION 

WRITE 

READ 

TAPE-WRITE 

OFFLINE-EXPIRATION 

ONLINE-EXPIRATION 


(CREATED 

userIwrote 


lists the complete specification 
for each file on a separate line 
(instead of listing successive 
generation numbers of the file on 
the same line, separated by 
commas; and instead of listing 
files of the same name and 
different type by file type only, 


indented under the 
file specification) 

first 

complete 

limits listing to files 

written after the date (or 
of week) and time given 

last 

day 

prints the size of 
pages 

the 

files 

in 

lists only files of 

size 

less 

than 


n pages 


lists, for the specified files, 
the 


© 

time and 

date 

of creation, 

or 

© 

time and 
changed , 

date 

or 

they were 

last 

• 

time and 
read, or 

date 

they were 

last 

© 

time and 
created , 

date 

or 

the tape copy 

was 


time and 

date 

of expiration 



Default ■ 

- WRITE 



gives the name of the user who 

created the file, or 

changed the file last 
Default - WRITE 


Listing Unneeded Files 

In preparation for deleting files so that your directory 
will fall within disk quotas, you can get a list of your 
larqest files by using the LARGER and/or SIZE subcommands, 
and of your oldest or least-used files with DATES, TIMES, 
and BEFORE. With FIND you can discover extra generations of 
files. 
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Finding Files of a Particular Age or Size 

To examine only files of a certain age or size, give the 
pair of subcommands BEFORE and SINCE, or LARGER and SMALLER, 
with appropriate arguments. 


Comparing Checksums of Files 

You can use the numbers reported by the CHECKSUM subcommand 
to compare two files: if they have differing contents they 
will almost certainly yield different values; and identical 
files will have the same checksums. The CHECKSUM subcommand 
causes a checksum of checksums as well. 


Special Cases 

Asterisks Appearing Before Filespecs 

An asterisk (*) appearing before a filename in the response 
to a DIRECTORY command indicates a possible hardware-related 
error, one caused by a read operation at a marginally 
functional area of disk. To test whether there actually is 

an error in the file, use the COPY command to copy the file 

to a new specification. If the COPY command succeeds, there 
is no error in the file, and no asterisk will precede the 
new file specification. If the COPY command fails, you 
should move the disk to another drive and repeat the 
command. If it still fails, you may have to write your own 

program to recover everything but the missing part of the 

file (usually, just one page). 

DIRECTORY-class Commands for Labeled Magnetic Tapes 

The FDIRECTORY , TDIRECTORY , and VDIRECTORY commands for 
labeled magnetic tapes are equivalent to the DIRECTORY 
command for labeled magnetic tapes. All these commands 
rewind the tape set to the beginning of the first volume, 
print a directory of files, then rewind the set again. You 
can give only these subcommands when using DIRECTORY-class 
commands with labeled magnetic tapes: ALPHABETICALLY, 

DOUBLESPACE, HEADING, LPT, NO, OUTPUT, REVERSE, and 
SEPARATE. 


Effect on Memory and Terminal 

The DIRECTORY command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


FDIRECTORY 

TDIRECTORY 

VDIRECTORY 


(Full DIRECTORY) 
(Time-ordered DIRECTORY) 
(Verbose DIRECTORY) 


other DIRECTORY-class 
commands for performing 
related functions 
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Examples 


1. Obtain a listing of your files. 

@ D I RECTORY 

PS : < HERR I CK > 

4-UPED.TXT. 13 
ACCT20.F0R. 1 
DUMPER. MAC. 1 
F-0. DIRECTORY. 1 
FORD . CTL . 2 .3 ,4 .5 .6 
MEM0.CMD. 1 
.FIL, 1 
. FRM . 2 

MULT I P . FOR . 2 

Total of 13 files 
@ 


2. Use a DIRECTORY command with the EVERYTHING subcommand to get 
complete information on the specified file. 


^ DIRECTORY UERCBL.BAT, 
@ @ E U E R Y T H I N G 
@@ 


M I SC : < LATTA > 

PGS Bytes (SZ) 

Write Read Tape- write 

UERCBL.BAT. 1 ! P777700 5 A34 1 0 0(0) 

8 - N o v - 7 9 1 1:15:02 Never Never 

e 


Ret Creation 

Creator Writer 
1 8 - N o v - 7 9 11:15:02 

LATTA LATTA 


3. Use a DIRECTORY command with a filespec consisting of 
wildcard characters and the account attribute ( ;A) to find 
out which files' storage fees are being charged to account 
MONITOR. 

e PIRECTQRY *.*;amqnitqr 

PS :< HERR I CIO 
FORD. CTL. 2 
MEMO. FRM. 2 

Total of 2 files 

@ 
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4. Find out what files of type .TXT there are in your connected 
directory and in one to which you have group rights. 

@ D I RECTORY *.TXT, < S ART I N I >* . TXT 

PS :< HERR I CIO 
4-UPED.TXT. 13 
MAIL.TXT. 1 
REMARK .TXT. a 

Total of 3 files 

P S : < S A R T I N I > 

CHAP21 .TXT. 33 
CHAPT2.TXT . IB 
CHAPT3 . TXT . B 
PR I V ATE . TXT . 1 
TEST , TXT . 1 

Total of 5 files 

Grand total of B files 

s 


5. Give a DIRECTORY command with the BEFORE and SINCE 
subcommands to find out which files were changed during the 
week of March 6, 1979. 

@ D I RECTORY > 

@@ BEFQRE 3-12-73 
BB S I NCE 3-5-79 
BB 


PS : < HERR I CK > 
DIVIDE. FOR. a 
MULT I P . FOR . 2 
QUOTNT.EXE. 1 
SQUARE . EXE . 1 

Total of 4 files 
B 
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Function 


The DISABLE command suspends any special capabilities, such as 
those of Wheel or Operator, that the system manager has given 
you . 


Format 


$DISABLE (CAPABILITIES) 

C 


Characteristics 


Resumption of Standard Prompt 

The DISABLE command causes the system to resume the standard 
at sign prompt (@) in place of the dollar sign prompt ($), 
which indicated enabled capabilities. 

Warning 


Disabling Promptly 

Be sure to disable your capabilities as soon as you have 
finished using them, so that you or a program you run cannot 
accidentally damage the system. 


Effect on Memory and Terminal 


The DISABLE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


ENABLE for activating any capabilities that the system 

manager has given you 


Examples 


1. Disable your capabilities. 

$ D I SABLE 
§ 
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2. Try copying a file from a directory to which you have no 
access. Then enable your capabilities (assuming you have 
been granted capabilities), copy the file, and give up your 
capabilities with the DISABLE command. 

B OOTY <MON-SPCS>FFE . SPC 

?Di rectory access privileges required 

6 ENABLE 

$ C 0 P Y < M Q N - S P C 5 > F F E . SPC 
< MON- SPCS >FFE . SPC . 1 => FFE.SPC.2 [OKI 
$ D I SABLE 
@ 
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Function 


The DISCARD command gives up the tape copy of specified on-line 
files. 


Format 


0DISCARD (TAPE INFORMATION FOR FILES) filespec,... 

where 

filespec is the specification of a file 

whose tape copy you want to discard 

'••• means that after commas you can 

give more arguments of the form 
already shown 


Characteristics 


Action of DISCARD 

The DISCARD command causes the tape pointer in the FDB (File 
Descriptor Block) of the specified file to be deleted. It 
does not actually destroy the tape copy of the file. (See 
also Hints - Undoing DISCARD, below.) 

Withdrawing Archive Status of Files 

When you give the DISCARD command for an on-line archived 
file, you withdraw archive status from the disk copy of the 
file. That is, the file becomes an ordinary disk file, 
which you can edit or delete if you wish. 

DISCARD for Non-archived Files 

You can also use the DISCARD command to give up the tape 
copy of files that have been migrated to tape 
(automatically, by the system) and then retrieved using the 
RETRIEVE command. 
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Hints 


Undoing DISCARD 

You receive a MAIL message from the operator for every file 
whose tape copy you discard. The message gives the tape 
number, save set number, and file number within the saveset 
of each tape copy. If you have given the DISCARD command 
for a file and later wish to use the tape copy, you may be 
able to recover it using this information, as long as the 
tapes have not yet been recycled. 


Effect on Memory and Terminal 


The DISCARD command does not affect memory, and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


ARCHIVE 


for requesting that a permanent tape 
copy of specified files be made 


DELETE (with CONTENTS-ONLY subcommand) 

for deleting only the disk copy of files 
that also have a tape copy 


RETRIEVE for requesting that an off-line file be 

restored to disk 


Examples 


1. Discard the tape copy of a file. 

@ D I SCARP TE5TER.EXE 
TESTER . EXE . 1 [OKI 

@ 


117 



DISCARD (Cont.) 


2. Attempt to alter an archived file. When you find out it has 
archive status, discard its tape copy (this revokes its 
archive status) and perform the alteration. Archive the 
resulting file and check its status. 

B APPEND FDO.LOG DRCHIUE.TXT 
FOO.LOG. 1 

?File has archive status* modification is prohibited: DRCHIUE.TXT. 1 
@ D I SCARP DRCHIUE . TXT 
DRCHIUE.TXT. 1 [OK] 

B APPEND FOO.LOG DRCHIUE.TXT 
FOO.LOG. 1 [OK] 

@ 

6 ARCHIUE DRCHIUE.TXT 
DRCHIUE.TXT. 1 [Requested] 

B INFORMATION ARCH I UE- STATUS DRCHIUE.TXT 
DRCHIUE.TXT. 1 Archive requested 

@ 
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Function 


The DISMOUNT command gives up access to the specified structure 
or tape set. 


Format 


@DISMOUNT medium (NAME) dev: /switch(es) 


where 

medium 


dev : 


/switches 


is one of the following: 

STRUCTURE - for dismounting file 

structures (disk packs) 

TAPE - for dismounting magnetic 
tapes 

is either the structure identification 
(or alias) , or a logical name referring 
to the tape set, e.g., the tape setname 
specified in your previous MOUNT 
command, or a logical device name of the 
form MTn : . It must be of 39 or fewer 
alphanumeric characters, and must be 
terminated by a colon. 

are keywords, chosen from the list 
below, indicating your choice of 
DISMOUNT command options 


DISMOUNT Command Switches 
(for use with argument STRUCTURE only) 


Switch 


/NOWAIT tells the system to return 

your terminal to TOPS-20 
command level as soon as you 
give the DISMOUNT command, and 
to send a message to your 
terminal when the request has 
been processed. Otherwise, 
your terminal waits for the 
message . 
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DISMOUNT Command Switches (Cont.) 


Switch 


/REMARK:" remark" 

sends the specified remark (of 
119 or fewer characters, which 
must be enclosed in quotation 
marks (")) to the operator 
when he is notified of your 
request. The remark is sent 
only if you also include the 
/REMOVE switch. 

/REMOVE tells the operator that you 

want him to physically 
dismount the structure from 
the drive; makes the 
structure unavailable for 
further mount requests. See 
also Hints - Action of 
DISMOUNT Command Including 
/REMOVE Switch, below. 

/STRUCTURE- ID : structure identification 

gives the name of the 
structure as recorded in the 
disk(s); used when you give 
some alias as argument dev:, 
above. See Hints - Using the 
/STRUCTURE-ID Switch, below. 


Characteristics 


Action of DISMOUNT STRUCTURE Command 


Ordinary DISMOUNT STRUCTURE 

The DISMOUNT STRUCTURE command reduces by 1 the mount 
count of the specified structure (i.e., the number of 
users who have given a MOUNT but not a DISMOUNT command 
for the structure) if you had given a previous MOUNT 
command for it. An ordinary DISMOUNT STRUCTURE command 
does not withdraw the structure from system use. 
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Including /REMOVE Switch 

If you include the /REMOVE switch when giving the 
DISMOUNT STRUCTURE command, the specified structure is 
made unavailable for further mount requests. The 
operator is informed of your dismount request, and any 
further action depends on him. If he denies your 
request, the structure is again made available to other 
users; if he grants your request, the structure 
remains unavailable for further mount requests, and is 
taken off line and physically removed. Under extreme 
conditions the operator may take a structure off line 
and physically remove it even though some users have 
not dismounted the structure. Before doing so, he will 
usually send a message to such users to allow them to 
close their files. 

Action of DISMOUNT TAPE Command 

The DISMOUNT TAPE command unloads the currently mounted 
volume of the specified tape set (i.e., rewinds it 
completely onto its source reel) so that it can be 
physically removed by the operator, and returns the tape 
drive to the pool of available resources. (Note that if the 
/NOUNLOAD switch was given in your original MOUNT command, 
no volumes are unloaded by the system or removed by the 
operator, even after your DISMOUNT command is completed.) If 
a logical name (e.g., the setname of the tape set) is used 
in the DISMOUNT command to specify the tape set, the system 
also withdraws the definition of the logical name. Use 
DISMOUNT TAPE only for tape drives having device names of 
the form MTn : , i.e., drives obtained using the MOUNT 
command. Use UNLOAD to unload tapes from drives having 
device names of the form MTAn : . 


Hints 


Omitting "medium" Argument 

If the dev: argument of your DISMOUNT command will be 
unambiguous (i.e., you do not have both a structure and a 
tape set mounted using the same device name) , you need not 
specify the medium. The shortened command, DISMOUNT 
dev :/switch (es) , is sufficient. 

Using the /STRUCTURE-ID Switch 

The /STRUCTURE-ID switch gives the name of the structure as 
recorded in the disk(s) of the pack itself, where it is used 
by the system for identification. You may use this switch 
to dismount a structure that had been mounted using an alias 
different from its structure identification. (See Hints 
Using the /STRUCTURE-ID Switch, in the MOUNT command 
descr iption . ) 
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Using INFORMATION VOLUMES before DISMOUNT TAPE 

If you give the INFORMATION VOLUMES command before 
dismounting a tape set, the system will respond with a list 
of the volids for mounted volumes, including volids for any 
volumes newly added to the set. You should keep an 
up-to-date record of these for use with further MOUNT 
commands . 


Effect on Memory and Terminal 


The DISMOUNT command does not affect memory, and, if you have 
included the /NOWAIT switch, leaves your terminal at TOPS-20 
command level. If you have not given the /NOWAIT switch, your 
terminal waits until the system has processed your request, or 
until you give a CTRL/C to return to TOPS-20 command level. This 
CTRL/C does not cancel your request. 


Related Commands 


CANCEL for withdrawing mount requests before they are 

processed 

INFORMATION AVAILABLE DEVICES 

for finding which tape devices (if any) have been 
assigned to your job 

INFORMATION MOUNT-REQUESTS 

for finding out information about pending mount 
requests for structures and tape sets, and 
currently mounted tape sets 

INFORMATION STRUCTURE 

for finding out information about the specified 
mounted structure, including its mount count and 
the names of users who have given the MOUNT, 
CONNECT, and ACCESS commands for the structure 

INFORMATION VOLUMES 

for finding out the volids of all mounted volumes 
(including newly created volumes) of a tape set 


Examples 

1. Dismount a magnetic tape set you have been using. 

@ DISMOUNT TAPE MT3 ; 

[Tape dismounted] 

@ 

2. Dismount the same tape set, referring to it by its setname. 
@ D I SMDUNT TAPE LAT: 

I Tape dismounted* logical name LAT : deleted] 

@ 
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3. Find out the volids of your tape set before dismounting it, 
in case the tape set has been extended to another volume. 

@ INFORMAT I ON '.'PLUMES MT3 : 

Volumes of tape set LAT: LAT * 0 0 J 1 G 
B DISMOUNT TAPE MT3 : 

[Tape dismounted] 

B 

4. Find out if you have any mount requests pending or any 
currently mounted tape sets. Dismount a currently mounted 
tape set (these display the actual device name (here, MTAO) 
in the column headed. Status). 

B INFORMATION MOUNT- REQUESTS/USER 
T a p e / D i s K Mount Queue: 

Volume Status T'/pe Write Res Name Res# Job# User 


UNLBLD MTAO Tape Looked UNLBLD 128 55 LATTA 

There is 1 Resuest in the Queue 
B DISMOUNT TAPE UNLBLD: 

[Tape dismounted * logical name UNLBLD: deleted] 

e 

5. Dismount a structure you have mounted. 

B DISMOUNT STRUCTURE SNARK : 

Structure SNARK: dismounted 
B 

6. Find out whether you have mounted a specific structure. Then 
dismount it. 

B INFORMAT I ON STRUCTURE LANG: 

Status of structure LANG: 

Mount count: 1 4 * open file count: 8 i units in structure: 1 
Domestic 

Users who have MOUNTed LANG: SCOHEN * REILLY . MILLER > LATTA 
Users ACCESS in 3 LANG: SCOHEN * REILLY > MILLER 
Users CONNECTed to LANG: SCOHEN* REILLY 

B DISMOUNT STRUCTURE LANG: 

Structure LANG: dismounted 
S 
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7. Find out whether your mount request for a structure has been 
satisfied yet (it has not). Use the CANCEL command to 
withdraw this request. 


B I NFQRMAT I ON MOUNT -REQUESTS 


Tape/DisK Mount 

Q u e u e : 






U o 1 u m e 

Status 

Type 

Write 

Req Name 

Req# 

Job# 

User 

MARK 

MTA 1 

Tape 

Enable d 

MARK 

12G 

GO 

HOUSEPIAN 

TAPE 

MT A3 

Tape 

Enable d 

TAPE 

148 

13 

WALLACE 

LATB 

W a i t i n 3 

Disk 


LATB 

157 

G5 

LATTA 


There are 3 Requests in the Queue 

B C ANCEL MOUNT 157 
Cl mount request canceled] 

@ 

8. Find out whether you can safely dismount and remove a 
structure you have mounted. Use the TALK command to ask 
another user to dismount the structure; then enable your 
capabilities and give a DISMOUNT command that will physically 
remove it. 


B I NFQRM AT I DN STRUCTURE LftTB : 

Status of structure LATB: 

Mount count: 2 > open file count: 0 t units in structure: 1 
F o r e i s n 

Users who haue MOUNT e d LATB: LATT A » GBLAINE 
Users ACCESS in S LATB : LATT A > GBLAINE 
No users CONNECTed to LATB: 

B SYSTAT GBLAINE 

71 127 EXEC GBLAINE 

S TALK GBLAINE 

LINK FROM LATTA. TTY 220 

B ! PLEASE DISMOUNT LATB : AS SOON AS CONPEN I ENT . I MUST RE MOUE 

B ITHE STRUCTURE, THANKS. 

B BREAK 

B I NFORMAT I ON STRUCTURE LATB: 

Status of structure LATB: 

Mount count: 1 . open file count: 0 , units in structure: 1 
Fo re i 3n 

Users who haue MOUNTed LATB: LATTA 
Users ACCESSinS LATB: LATTA 
No users CONNECTed to LATB: 

B END-ACCESS LATB :< OPERATOR > 

B ENABLE 

$ D I SMQUNT STRUCTURE LATB: /STRUCTURE- I D : PS : /REMOPE/REM- 
ARK : "PLEASE LEAOE LATB: ON RPOS CABINET" 

[Mount Request LATB Queued , Request-ID ISA] 

Structure LATB: removed 
$ D I SABLE 
B 
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Function 

The EDIT command lets you change or add to a file in a directory. 


Forma t 

@EDIT (FILE) /switch (es) input filespec (OUTPUT AS) output filespec 


where 









swi tch 

es 

are keywords. 

chosen 

from 

the 

lis 

t be 

low , 



indicating 

your 

choice 

of 

EDIT 

command 



options 









Defaults 

are 

shown 

in 

the 

list 

of 



swi tches 







input 

filespec 

is the specif 

ication 

of the 

f il 

e you 

want 

to 



edit 









Default 

- last 

file 

spec 

if ica 

tion 

and 




assoc 

iated 

switches 

you 

gave 




in a 

CREATE 

or 

EDIT 

command 




during the 

cur 

rent 

term 

inal 




sess i 

on 





output 

filespec 

is the specif 

ication 

with which 

you 

want 

to 


name the edited file 

Default - the input file specification, 
but with a generation number 1 
higher than the highest 
existing generation number 


Summary of EDIT Command Switches (Defaults in boldface) 

/BAK 

/C126 

/C64 

/DECIDE 

/DPY 

/EXPERT 

/INCREMENT : n Default n - 100 

/I SAVE :n 

/LOWER 

/M33 

/M37 

/NOBAK 

/NODECIDE 

/NONSEPARATORS 

/NONUMBER 

/NOVICE 


1 This manual assumes that you are using the EDIT program to edit. 
Refer to the Special Cases section below for information relating to 
other editors. 
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/NUMBER 

/OLD 

/OPTION : name 

/PLINES : n 

Default 

/R 

/READONLY 

/RONLY 

/RUN : f ilespec 

Default 

/SAVE :n 
/SEPARATORS 

/SEQUENCE 
/START : n 

Default 

/STEP : n 

Default 

/UNSEQUENCE 

/UPPER 
/WINDOW :n 

Default 


- 16 

le type - .EXE 

- argument of INCREMENT switch 

- 100 

- 10 


EDIT Command Switches 


/BAK 

/C 1 28 

/C6 4 

/DECIDE 

/DPY 

/EXPERT 

/INCREMENT : n 

/I SAVE :n 


causes an unedited copy of the file to be 
saved at the end of an editing session under 
the specification name.Qyp, where name.typ is 
the file's original specification 
Default 

specifies a 128-character alphabet, allowing 
insertion of control characters in an 
alternate format. See the TQPS-20 EDIT 
Reference Manual for details. 

specifies a 64-character alphabet, disallowing 
use of an alternate format for insertion of 
control characters 

Default 

lets you decide whether to accept or reject 
each change caused by the operation of the S 
(substitute) command of the EDIT program 

has no effect in the current monitor 

tells the EDIT program that you need only 
abbreviated error messages, and fewer warnings 
and reminders 

specifies the value that will be added to each 
line number of the file to obtain the next 
line number 

Default n - 100 

instructs the EDIT program to update the 
backup file of specification name.Qyp after 
every n lines you insert, instead of only at 
the end of the EDIT session 
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/LOWER 

/M33 

/M37 

/NOBAK 

/NODECIDE 

/NONSEPARATORS 

/NONUMBER 

/NOVICE 

/NUMBER 

/OLD 

/OPTION : name 

/PLINES :n 

/R 

/READONLY 

/RONLY 


EDIT Command Switches (Cont.) 

specifies that all alphabetic characters you 
type should be considered lowercase 
characters; give uppercase characters by 
preceding the corresponding lowercase 
character with a single quotation mark ('). 

has no effect in the current monitor 

has no effect in the current monitor 

prevents an unedited copy of the file from 
being saved at the end of an editing session 
under specification name.Qyp, where name.typ 
is the file's original specification 

ensures the automatic operation of the S 
(substitute) command of the EDIT program 
Default 

notifies the EDIT program that the characters 
. (period), $ (dollar sign), and % (percent 
sign) are to be regarded as ordinary textual 
characters and not as field delimiters 
(separators) in the file being edited 
Default 

suppresses the printing of line numbers with 
each line of a file 

tells the EDIT program that you want to see 
complete error messages and all appropriate 
warnings and reminders; opposite of /EXPERT 
switch . 

Default 

prints a line number for each line of the file 
Default 

causes the first backup file to be saved under 
the specification name.Zyp, where name.typ is 
the file's original specification 

sets any EDIT switches contained in lines of 
your SWITCH . INI file labeled with name (of six 
or fewer characters). The system expects this 
file to be in your log-in directory. 

specifies how many lines to print in response 
to each P (print) command of the EDIT program 
Default n - 16 

same as /READONLY 

prevents any changes to the file during the 
current session of the EDIT program, that is, 
makes it a read-only session 

same as /READONLY 
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EDIT Command Switches (Cont.) 


/RUN : f ilespec 


/SAVE :n 


/SEPARATORS 


/SEQUENCE 


/START : n 


/STEP: n 
/UNSEQUENCE 


/UPPER 


/WINDOW : n 


specifies the program to be run when you end 
the current session of the EDIT program with 
the G command 

Default file type - .EXE 

instructs the EDIT program to update the 
backup file of specification name.Qyp after 
every n EDIT program commands that modify the 
file 

notifies the EDIT program that the characters 
(period) , $ (dollar sign) , and % (percent 

sign) are not ordinary textual characters but 
are field separators in the accompanying file 

tells the EDIT program not to strip the line 
numbers from the file when the EDIT session 
ends 

Default 

specifies the first line number for the EDIT 
program to use when numbering the file 

Default n - argument of /INCREMENT switch 

same as /INCREMENT 

tells the EDIT program to strip the line 
numbers from the file when the EDIT session 
ends 

specifies that all alphabetic characters you 
type should be considered uppercase 
characters; give lowercase characters by 
preceding the corresponding lowercase 
character with a single quotation mark ('). 
Default 

specifies the number n (between 10 and 99) of 
pages to be held in memory during the EDIT 
session 

Default n - 10 


Characteristics 


Edit Mode or Input Mode 

The EDIT command runs the EDIT system program in Edit mode, 
which uses an asterisk prompt (*). (However, see also 
Special Cases - Using an Editor^Other than EDIT, below.) In 
Edit mode you can use any EDIT program commands to modify 
the specified file. If the EDIT program starts by printing 
the word Input instead of Edit, the specified file does not 
yet exist. you are then in Input mode, just as if you had 
used the CREATE command instead of EDIT. See the CREATE 
command description for details. 
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Saving Backup Files Periodically 

Whenever you use EDIT, be sure to keep an extra copy of the 
file you are modifying, in case of a system failure. By 
default the system renames the unedited copy of your file to 
name.Qyp at the end of an editing session. By using the 
/ SAVE : n switch you can have this backup file updated 
periodically during the editing session to reflect your 
edits . 

SWITCH . INI File 

If there is a group of EDIT command switches that you always 
or often use with EDIT or CREATE commands, put them into a 
file of specification SWITCH.INI in your log-in directory, 
in a line of that file beginning with "EDIT:abc", where abc 
is any set of characters you choose to identify the line. 
Then if you include the single switch /OPTION:abc when you 
give an EDIT or CREATE command, all these switches will be 
in effect. 


Hints 


Debugging Your Programs and Editing the Sources 

You can use EDIT to modify files containing source programs 
written in a programming language. The DDT and DEBUG 
commands run system programs that offer more efficient and 
powerful techniques for testing temporary corrections to 
your programs, but you should use the EDIT command to make 
final changes to the source files. 

Further Information 

For more information about the EDIT program, see the TQPS-20 
EDIT Reference Manual. 


Special Cases 


Using an Editor Other than EDIT 

The CREATE and EDIT command descriptions in this manual 
assume that these commands call on the EDIT program for 
their action. If your job uses another editing program 
(e.g., TV, the editing program designed especially for use 
with display terminals) , the switches and examples shown 
here will not be applicable. The editing program used by 
CREATE and EDIT is specified by logical name EDITOR: , so you 
can find out the name of this program by giving the command, 
INFORMATION LOGICAL-NAMES EDITOR:. The system-wide 
definition will be given first, followed by the job-wide 
definition (if any); the job-wide definition prevails if 
both exist. If the definition of EDITOR: is SYS : EDIT . EXE , 
the CREATE and EDIT commands will function as described in 
this manual. Otherwise, you must consult the appropriate 
manual (e.g., the TQPS-20 TV Editor Manual) for information. 


129 


EDIT (Cont.) 


You can use the DEFINE command to define logical name 
EDITOR: to be any editing program available at your 
installation. Then this program will be in effect when you 
give the CREATE or EDIT command. 

Attempting to Edit Archived Files 

If you attempt to edit an on-line archived file, the system 
will let you produce an edited version of the archived file, 
but will retain the original (archived) file unchanged under 
the specification name.Qyp (or name.Zyp if you included the 
/OLD switch in the EDIT command), where name.typ is the 
file's original specification. See also Hints - Editing 
Files of Type .Qyp, below. 

Editing Files of Type -Oyp 

If you edit a file of type .Qyp (i.e., any file whose type 
begins with the letter Q) , the EDIT program does not save 
the unedited copy as a backup file. In such cases, give the 
/OLD switch to retain the unedited copy under file type 
•Zyp. If the file of type .Qyp is an archived file, you 
will not be allowed to produce an altered version using the 
EDIT command unless you include the /OLD switch. 


Effect on Memory and Terminal 


The EDIT command clears memory, then loads the EDIT system 
program into memory, and leaves your terminal at command level 
(Edit mode) in that program. 

Related Commands 

CREATE for making new files 

DIRECTORY-class commands for getting lists of existing files 
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Examples 


1. Edit a file. 

B EDIT FILE. FDR 
Edit: FILE. FOR. i 
* 

2. Edit a file, requesting that an updated copy of the file be 
saved after every three EDIT program commands; ask that the 
first such backup file be saved under specification FILE.ZOR. 

B EDIT /SAUE:3/QLD FILE. FOR 
Edit: FILE. FOR. 1 
* 

3. Edit a large text file, adjusting several EDIT program 
parameters as you begin, and give new specifications for the 
output file. 

B EDIT /EXPERT /DECIDE/PLINES : 50 /WINDOW : 99 REMARK .TXT R 

EUI5I0N.TXT 

Edit: REMARK .TXT. 18 

* 

4. Create a SWITCH.INI file with one line for the switches used 
in Example 2, and one line for those in Example 3. Use this 
file to repeat Example 3. 

B ORE ATE SNITCH .INI 

Input: SWITCH. INI . 1 

0 0 1 0 0 EDIT: ABC/5AUE : 3/OLD 

0 0 2 0 0 ED IT :DEF /EX PERT /DECIDE/PLINES: 50 /WINDOW: 39 
00300 $ 

*E 

[SWITCH. INI . 1 1 

B EDIT /0PTI0N:DEF REMARK . TXT RE0ISI0N.TXT 
Edi t : REMARK . TXT . 18 
* 
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Function 


The ENABLE command activates any special capabilities, 
those of Wheel or Operator, that the system manager 
you . 


such as 
has given 


Format 


^ENABLE (CAPABILITIES) 
$ 


Characteristics 


Dollar Sign Prompt 

The ENABLE command causes the system to print a dollar sign 
prompt ($), indicating enabled capabilities, in place of the 
standard at sign prompt (@). The dollar sign prompt is 
printed after ENABLE even if you have not been granted any 
capabilities. 

Capabilities of Log-In Directory Only 

The ENABLE command activates only these capabilities that 
have been granted to the owner of your log-in directory. 
You do not receive any capabilities as a result of CONNECT 
or ACCESS commands or group memberships. 


Special Cases 


Dollar Sign Prompt in Batch Jobs 

Because a dollar sign placed in the location of a TOPS-20 
prompt could be confused with a batch command, the system 
precedes the enabled prompt with a space for batch jobs. 


Warning 


Disabling Capabilities Promptly 

Because your commands are much more powerful if you have 
capabilities enabled, you should disable them as soon as you 
have finished using them. Otherwise you or a program that 
you run could accidentally damage the system. 


Effect on Memory and Terminal 


The ENABLE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 
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Related Commands 


DISABLE for suspending any capabilities that 

the system manager has given you 

INFORMATION DIRECTORY for finding out which capabilities, if 

any, have been granted to the owner of 
a directory 


Examples 


1. Enable your capabilities. 

HENABLE 

$ 

2. Try to assign a plotter to your job before taking it off line 
for repairs. But it is already assigned to another user, 
whose terminal is set to refuse links. Enable your 
capabilities and ask him to deassign the plotter. Then 
disable capabilities. 

@ ASS I GN PLT2 : 

?PLT2: Already assigned to Job 29 
e SYSTAT 29 

29 53 EXEC R. SCHNEIDER 

@ T ALK R, SCHNEIDER 

?R e f u s e d * use "MAIL" to send mail to user 
i ENABLE 

$ T ALK R. SCHNEIDER 

LINK FROM F. DOMINO > TTY 221 

$ ;R0BIN - PLEASE DEASSIGN PLT2 : . IT MUST BE TAKEN OFF LINE 
$ iFOR MAINTENANCE . USE PLT3: INSTEAD. THANKS. 

§ 5 OKAY , SURE. 

@DE ASS I GN PLT2 : 

@ 

$ BRE AK 
$ D I 5 ABLE 
@ 
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Function 


The END-ACCESS command terminates your ownership rights to an 
accessed directory, as well as group rights borrowed from its 
owner . 


Format 


@END-ACCESS (TO DIRECTORY) dev : <directory> 
where 

dev : <directory> is the directory to which you want to end 

access 

Default dev: - your connected structure 

Default <directory> - the directory (on 

the specified 

structure) of the 
same name as your 
connected 
directory 


Hints 


Implicit END-ACCESS 

You can access only one directory at a time on each mounted 
structure. Each ACCESS command ends access obtained by any 
previous ACCESS command for a directory on the specified 
structure. Therefore you do not need to give the END-ACCESS 
command if you access another directory on the structure, or 
if the structure is dismounted. 

Restoring Previous Rights 

END-ACCESS does not restore owner and group rights obtained 
by a previous ACCESS command for the specified structure. 
Give another ACCESS command to regain these. (Note that you 
must access your log-in directory to regain group rights 
obtained by the LOGIN command, lost by accessing another 
directory on PS:.) 


Effect on Memory and Terminal 

The END-ACCESS command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


ACCESS 


for obtaining ownership rights to a directory 
the group rights of the owner 


and 



END-ACCESS (Cont.) 


DISMOUNT for decrementing the mount count of a previously 

accessed structure 

INFORMATION STRUCTURE 

for finding out who is accessing a structure 


Examples 


1. Give up your access rights to another user's directory. 

B END- ACCESS < H D L L ft N D > 

@ 

2. Access another user's directory, copy a file from it, and 
give up your rights to it. Then give a command that depends 
on your own group rights. (It fails.) Access your own 
directory to establish these, and repeat the command, 
successfully this time. 

i ftCCESS < HOLLAND) 

P a s s w o r d : 

6 C0PY < HOLLAND >D 1ST . LS I 
< H 0 L L A N D > D I S T . L S T .2 => DIST.LST.2 [OKI 
B END- ACCESS < HOLLAND) 

B INFORMATION DIRECTORY < L A T T A . * > > 

? N o such directory 
B ACCESS < L A T T A > 

B INFORMAT I ON DIRECTORY < L A T T A . * > . 

BB NAME-ONLY 

BB 

Name PS:<LATTA.A> 

Name PS : < LATTA . A . F-0 > 

S 

3. Mount a structure, and access a user's directory there. Get 
a listing of his files of type .TXT. End the access and 
dismount the structure. 

B MOUNT STRUCTURE 5NARK : 

Structure S N A R K : mounted 
B ACCESS SNARK :< HOLLAND > 

P a s s w o r d : 

B D I RECTORY SNARK :< HOLLAND >*, TXT 

SNARK :<H0LLAND> 

ACCT.TXT. 1 
MAIL. TXT. 2 
REMARKS.TXT . 1 
SYSTEM . TXT . 1 


Total of A files 
B END-ACCESS SNARK : -(HOLLAND > 
B DISMOUNT STRUCTURE SNARK: 
Structure SNARK: dismounted 
S 


135 



EOF 


Function 


I 


The EOF command writes an end-of-file mark on the specified 
magnetic tape. Use this command for unlabeled tapes only. 


Format 


@ EOF (DEVICE) dev: 
where 

dev: is the name of the magnetic tape drive on which you 

want to write an end-of-file mark 


Hints 


EOF Seldom Needed 

Because tape-writing programs and commands automatically 
write end-of-file marks in the appropriate places, you do 
not ordinarily need the EOF command. But it can be useful 
if such a program is interrupted (by your CTRL/C or by a 
system failure and restart) and you want to preserve the 
information already written. Also, you can shorten files on 
an existing tape by giving an EOF command at the desired 
point. 


Restrictions 


EOF With Open Files 

If you have given a CTRL/C to exit from a program that has 
opened a magnetic tape drive and you then give the EOF 
command for that tape drive, the system will first allow you 
to close the associated file. You must do so for the EOF 
command to succeed, but you will probably be unable to 
continue the program from that point, because the file will 
now be closed. 


Effect on Memory and Terminal 


The EOF command does not affect memory and leaves your terminal 
at TOPS-20 command level. 
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Related Commands 


BACKSPACE 

REWIND 

other TOPS-20 commands for controlling magnetic 
tape drives 

SKIP 

UNLOAD 


Examples 


1. Put an end-of-file mark (EOF) on your magnetic tape. 

@ EQF MTAO : 

@ 
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Function 

The EXAMINE command displays the contents of a specific memory 

location . 

Forma t 

0EXAMINE (MEMORY LOCATION) octal or symbolic address 
Ou tpu t 

Contents of Memory Location or Message 

When you complete an EXAMINE command, the system prints the 
memory address examined, followed by a slash (/) and its 
contents. If you previously used the SET TYPEOUT MODE 
SYMBOLIC command, this information is both in symbolic and, 
in parentheses, numeric (octal) format. (The numeric 
information will always appear for this setting of the 
command; symbolic information will appear if the system 
finds that it is different from the numeric.) 

Generally the numeric format shows two 6-diqit octal numbers 
separated by a pair of commas (,,). If you do not see this 
pair of commas, only the right half of the memory location 
is being displayed; as the left half is 0. However, if you 
are not permitted to examine this location, the system 
prints only a message telling you of the restriction. 


Using Symbols 

For symbols that are defined in multiple modules of a 
program, you can be specific by giving the module name 
followed by an ampersand (&) and the symbol name. 

Abbreviating EXAMINE 

The EXAMINE command can be abbreviated by the single letter 

E. 

Default Argument for EXAMINE 

The argument of your current EXAMINE command defaults to a 
value greater by 1 than the last address examined, allowing 
you to inspect a section of memory with only a minimum of 
typing. But if you gave a more recent DEPOSIT command, the 
argument of your current EXAMINE command defaults to that 
address, allowing you to verify the deposit. 

Using EXAMINE with Inferior Processes 


To 

exami 

ne memory 

for 

a process inferior 

to 

the 

one 

immediate 

ly below 

the 

TCPS-20 command proces 

sor , 

you 

must 

give 

the 

FORK comma 

nd to 

specify this process 

before 

using 
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EXAMINE. Remember that to run an inferior process after 
examining it, you must ensure that all superior processes 
are running too. Give the FORK 1 and CONTINUE commands to 
let the top-level process continue its inferiors. 

Effect on Memory and Terminal 

The EXAMINE command does not affect memory and leaves your 

terminal at TOPS-20 command level. 

Related Commands 

DDT for calling a debugging program, 

allowing more efficient examination 
of memory 

DEPOSIT for changing the contents of a 

specific memory location 

FORK for selecting the process whose 

memory you want to examine 

INFORMATION MEMORY-USAGE for displaying a list of memory 

pages, their contents and status 


Examples 

1. Examine location 550 of the program in memory. 

B E X A M I N E 550 

550/ 74473**414155 

B 


2. Examine location 20, first in numeric typeout mode, then in 
the symbolic mode. 

@ SET TYPEOUT MODE (TO) NUMERIC 
B E X ft M I N E (MEMORY LOCATION) 20 
20/ 104000 * *56 

@ 5ET TYPEOUT MODE (TO) SYMBOLIC 

B EXftMINE (MEMORY LOCATION) 20 

P+1/ 104000 », .JBBLT+1 1 (20/ 104000**56) 

@ 


3. Put a program into memory and find out what pages it 
occupies. Examine a location on page 2, and then (using the 
abbreviated form of the EXAMINE command) one on page 400. 

B GET DMN 

B INFORMATION MEMORY-USAGE 

5 . p a 3 e s * Entry vector 1 o c 400010 1 e n 254 0 0 0 

0-3 DMN.EXE, 1 1-4 R , CW , E 

400 DMN.EXE. 1 5 R , CW , E 

B EXftMINE 2550 
2550/ 600170 

B E 400550 
400550/ 0 
B 
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Function 

The EXECUTE command loads your program into memory, compiling the 
source file first if necessary. Then it starts the program. 

Forma t 


0EXECUTE (FROM) /switch (es) source/switch (es) object,... 

where 

switches are keywords chosen from the list below, indicating 

your choice of EXECUTE command options. They have 
different effects depending on their position in the 
command line: placed before all files in the 

command, they act on defaults for all; otherwise 
thev affect only the nearest preceding file. 

Defaults are shown in the list of switches 

source is the file specification of the source program. 

The filename must be of 6 or fewer characters, and 
the file type of 30 fewer characters; you cannot 
use a generation number. This argument is not 
necessary if you supply an object filespec. 

object is the file specification of the object program. 

The filename must be of six or fewer characters, and 
the file type must be .REL; you cannot use a 
generation number. This argument is not necessary 
if you supply a source. 

Default (if you give neither source nor object 
filespecs) - last filespecs and 

associated switches you gave in a 
LOAD-class command 

, ... means that, after commas, you can give more 

arguments (switches, source, and object) of the form 
already shown 

Summary of EXECUTE Command Switches (defaults in boldface) 


/ 68-COBOL 

/74-COBOL 

/ALGOL 

/COBOL 

/COMPILE 

/CREF 

/FORTRAN 

/LANGUAGE-SWITCHES : "/switch (es) " 

/LIBRARY 

/LIST 

/MACRO 

/MAP 
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/NOCOMPILE 

/NOLIBRARY 

/NOLIST 

/NOOPTIMIZE 

/NOSEARCH 

/OPTIMIZE 

/RELOCATABLE 

/SEARCH 

/STAY 

Descriptions of these switches are given below. Although the 
system will not reject switches described under any of the 
LOAD-class commands, only those switches commonly associated with 
EXECUTE are described here. 


EXECUTE Command Switches 


/ 68-COBOL 

/74-COBOL 

/ALGOL 

/COBOL 

/COMPILE 


/CREF 


/FORTRAN 


compiles the file using the COBOL-68 compiler 
Default for files of type .CBL 

compiles the file using the COBOL-74 compiler 

compiles the file using the ALGOL compiler 

compiles the file using the COBOL-68 compiler 

forces compilation of the source file even if a 
current object file already exists. Use this 
switch along with a /LIST or /CREF switch to 
obtain listings when you have current object 
files . 

creates a file containing cross-reference 
information for each compilation. The filename 
is that of the object file; the file type is 
. CRF . Use the CREF command to obtain a listing 
of the file. (For COBOL files this switch 
automatically produces a cross-reference 
listing . ) 

compiles the file using the FORTRAN compiler 

Default for switches specifying compiler 
language, in the absence of a 
standard source file type 


/LANGUAGE-SWITCHES: "/switch (es) " 

passes the specified switches to the compiler 
that will process the file(s) to which this 
switch applies. You must include the switches 
in double quotation marks (" "). 


/LIBRARY 


same as /SEARCH 


/LIST prints a line printer listing of the program in 

ASCII format; the name of this listing is the 
filename of the object file. The /CREF switch 
overrides /LIST when they both apply to the 
same file. 
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EXECUTE Command Switches (Cont.) 


/MACRO 

/MAP 


/NOCOMPILE 


/NOLIBRARY 

/NOLIST 

/NOGPTIMIZE 

/NOSEARCH 


/OPTIMIZE 


/RELOCATABLE 

/SEARCH 


assembles the file using the MACRO assembler 

produces a loader map and stores it in the file 
object. MAP, where object is the name of the 
module containing the start address; or (if no 
start address) nnnLNK.MAP, where nnn is your 
job number. 

prevents compilation if the object file is 
current; otherwise it forces compilation. Use 
this switch to cancel a /COMPILE or 
/RELOCATABLE switch. 

Default 

same as /NOSEARCH 

prevents a line printer listing of the program 
Default 

prevents the generation of a globally optimized 
object file. (For FORTRAN programs only.) 
Default 

requires all modules in the object file library 
(the file accompanied by this switch in the 
command line) to be loaded even if they are not 
called by your program. Use this switch to 
cancel a /SEARCH switch. 

Default 

generates a globally optimized object file, 
i.e., one that runs as quickly as possible. 
(For FORTRAN programs only, and only if you do 
not also give the /DEBUG switch (see the DEBUG 
command description).) 

prevents compilation of the source file, 
forcing use of an existing object file even if 
the object file is out of date 

requires that the object file library (the file 
accompanied by this switch in the command line) 
be searched for modules called by your program 
or by a program subroutine. Only these modules 
are loaded, along with modules called from 
system libraries, which are always searched. 


142 



EXECUTE (Cont.) 


EXECUTE Command Switches (Cont.) 

/STAY returns your terminal to TOPS-20 command level 

so that you can perform other work while the 
system continues to execute your program. You 
immediately receive the TOPS-20 prompt (@ or 
$) , and can then issue any user command. But 
be careful with commands that run programs, 
because those commands may clear memory and 
terminate the current process. Also, you could 
easily send incorrect data to programs 
expecting terminal input. This switch saves 
you from having to: issue a "T to make sure 
execution has begun; give a ~C to halt the 
job; and issue a CONTINUE STAY command to 
remain at command level during execution. 


Characteristics 

Compiling New Sources Only 

Before executing programs, the system ordinarily compiles 
any source (and only those sources) whose write date is more 
recent that that of the object file of the same name. You 
can override this action with the /COMPILE or /RELOCATABLE 
swi tch . 

Using Standard File Types 

If you specify source files with standard types (.FOR, .MAC, 
. CBL , or .ALG) in an EXECUTE command, the system 
automatically calls the appropriate compiler when 
compilation is necessary. If you specify source files by 
filename only, the system searches your connected directory 
in the above order for a file of this name and a standard 
type. To execute programs from sources that have 
nonstandard file types, give a switch to indicate the proper 
compiler (/FORTRAN, /MACRO, /COBOL, or /ALGOL). A switch 
wili take precedence over a standard file type if they 
indicate different languages. If no compiler is indicated 
with either a switch or a standard file type, the FORTRAN 
compiler is used. 


Hints 


Commas Between Filespecs 

If you give two or more filespecs separated by commas as 
arguments to EXECUTE, the loaded programs exist in memory at 
the same time and will act as a single program. You can use 
this feature to substitute one module for another under 
varying conditions or for different applications. 

Plus Signs Between Filespecs 

If you give two or more filespecs separated by plus signs 
(+) as arguments to EXECUTE, they are treated as a single 
file by compilers. Their object module is stored under any 
filename given as the "object" argument of the command, or 
(if none) under the last filename in the group and file type 
.REL. 
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Indirect Files as Arguments 

You can store the arguments (source and object filespecs, 
switches) of an EXECUTE command in an indirect file, and 
specify them by typing an at sign (@) and its filespec as an 
EXECUTE command argument. 

Establishing Default Arguments with the SET Command 

You can issue the SET DEFAULT COMPILE-SWITCHES command to 
set up default global arguments to the EXECUTE command. 
Insert this SET command in your COMAND.CMD file to change 
your own defaults permanently. 

Running LINK Directly 

The EXECUTE command automatically runs LINK, the system's 
loader program, but if you require control of the loading 
process you can run LINK directly. See the TQPS-20 LINK 
Reference Manual. 


Restrictions 


Switches Requiring Compilation 
/CREF 

/LANGUAGE- -SWITCHES 

/LIST 

/NOLIST 

/NOOPTIMIZE 

/OPTIMIZE 

The above switches will not take effect unless the EXECUTE 
command causes a new compilation of the relevant source 
file. See Characteristics - Compiling New Sources Only, 
above, for more information. 


Effect on Memory and Terminal 


The EXECUTE command clears memory, loads the appropriate compiler 
if necessary, then loads and starts your program. It leaves your 
terminal at program command level (if any) within your program. 


Related Commands 

COMPILE, LOAD, and DEBUG other LOAD-class commands for 

performing related functions 

RUN for running executable programs 
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Examples 

1 . 


3. 


4 . 


5. 


TOPS-20 


Execute a program, indicating the language with a standard 
file type. 

B EXECUTE CAFN . FOR 
FORTRAN: CAFN 
LINK: LOADING 

CLNKXCT CAFN EXECUTION] 

END OF EXECUTION 

CPU TIME: 0.04 ELAPSED TIME: 0.89 
EXIT 

e 

Execute a program, indicating the language with a switch. 
Specify the /STAY switch to return immediately to TOPS-20 
command level. 

B EXECUTE CAFN/FORTRAN/STAY 
B 

Execute two programs, requesting a cross-reference file for 
one of them. 

B EXECUTE CAFN > TAFN/CREF 

FORTRAN: CAFN 

MAIN. 

FORTRAN: TAFN 
MAIN. 

LINK: LOADING 

CLNKXCT TAFN EXECUTION] 

END OF EXECUTION 

CPU TIME: 0 . 04 ELAPSED TIME : 0.15 

EXIT 

S 


Combine two source programs into a single object program, and 
run this program. 

B EXECUTE CAFN+TAFN 
FORTRAN: CAFN 
MAIN. 

MAIN. 

LINK: LOADING 

CLNKXCT TAFN EXECUTION] 

END OF EXECUTION 

CPU TIME: 0.04 ELAPSED TIME: 0. IS 

EXIT 

B 


Execute an ALGOL program, ensuring that the compilation 
includes required modules only; request a map. 

B EXECUTE /CQMPILE/MAP C A LEN D / ALGOL , A LGMOD . L B R / SE ARC H 
ALGOL : CALEND 
LINK: LOADING 

EXIT 

B 
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Function 


The EXPUNGE command permanently erases all the deleted files from 
a directory. 


Format 


@EXPUNGE (DIRECTORY) dev : <d ir ec tor y > , 
@@subcommand 

@@ 


where 

dev : <directory> is the name of the directory you wish to 

expunge; you may use wildcard characters to 
expunge more than one directory. 

Default dev: - your connected structure 

Default <directory> - the directory (on 

the specified 

structure) of the 
same name as your 
connected 
directory 

Default (if no arguments - your 

are given) connected 

directory 

means that after a final comma you can give 
@@ one or more (optional) subcommands on 

@@ . successive lines 


subcommand is a keyword chosen from the list below, 

indicating your choice of EXPUNGE command 
options 


EXPUNGE Command Subcommands 


DELETE deletes and expunges temporary files, i.e., those 

with the Temporary ( ;T) attribute, created by some 
system programs to hold interim data. Do not use if 
you will have any further need of these files. 

PURGE expunges all files which you have opened but not 

closed 


REBUILD 


rebuilds 


the symbol table of the directory named 
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Output 


After a successful EXPUNGE command, the system reports the number 
of disk pages freed. If the expunged files are small, there may 
be no pages reported freed. Also, if deleted files are mapped, 
they will not be expunged, and so will not contribute to the 
number of pages freed. Occasionally the system will report a 
negative number. This can mean that files were being written in 
the directory during the EXPUNGE, or (especially if you include 
the REBUILD subcommand) that previous computations of directory 
size had not adequately accounted for some files, e.g., files 
written near the time of a system crash and reload. 


Hints 


Using the REBUILD Subcommand 


The REBUILD subcommand is not needed under usual conditions, 
as the system performs this action automatically. Use 
REBUILD if a message is printed on your terminal advising 
you to rebuild the symbol table of a directory, or if the 
"Pages assigned" parameter reported by an INFORMATION 
DISK-USAGE command shows two page counts (one within 
parentheses) differing by more than, say, two pages. Note 
that in this last case REBUILD will merely reduce the 
difference, not eliminate it, especially if the directory 
has subdirectories beneath it. 


Using the PURGE Subcommand 

The PURGE subcommand is useful chiefly for removing the 
remains of files that were being created at the time of a 
system crash or a structure dismount. Do not give it while 
anyone might be using the directory, because that user's 
program might be deprived of necessary files as a result. 


Special Cases 


Files With the "Permanent" Attribute 

The system erases only the contents of any files that have 
the Permanent attribute (e.g., MAIL . TXT in your log-in 
directory) when you try to expunge them. Their file 
specifications remain among your deleted files, and cannot 
be removed by TOPS-20 commands. 


Effect on Memory and Terminal 


The EXPUNGE command does not affect memory and 
terminal at TOPS-20 command level. 


leaves your 
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Related Commands 


DELETE 

for 

marking files to 

be 

later 


expunged 



DIRECTORY-class commands 

for 

obtaining lists 

of 

file 


spec 

if ications 



INFORMATION DISK-USAGE 

for 

finding out the 

size 

of a 


directory 


Examples 


1. Expunge all deleted files from your directory. 

B EXPUNGE 

PS:<LATTA> CB paies freed] 
i 

2. Find out how much of your disk space is in use and how much 
is occupied by deleted files. Delete some of your backup 
files, then give the EXPUNGE command to erase all of these. 

@ I NFORMAT I ON DISK-USAGE 
M I SC : < LATTA > 

154 Paaes assigned > 101 in use » 53 deleted 
590Workin3 p a 3 e s » 590 Permanent paaes allowed 
33371 Paaes free on PS: 

B DELETE * , 0* 

BLUE . OAR . 1 [OK] 

REMARK. OXT. 1 [OK] 

RIMOUSKI .OXT, 1 [OK] 

B EXPUNGE 

PS:<LATTA> C5G paaes freed] 

B 
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Function 


The FDIRECTORY (Full DIRECTORY) command is equivalent to the 
DIRECTORY command with the subcommands CRAM, EVERYTHING, and 
NOHEADING. Use the same format and subcommands with FDIRECTORY 
as with DIRECTORY. For further information, see the DIRECTORY 
command description in this manual. 

When used with magnetic tapes, the FDIRECTORY command is 
equivalent to DIRECTORY for magentic tapes. 


Examples 


1. Get a "Full DIRECTORY" listing, on your terminal, for one of 
your files. 

B FDIRECTDRY TESTF1 . FOR 
M I S C : < L A T T A > 

TESTF1 .FOR. 175P7777005A341 1 162(7) 1 25-0ct-79 11:17:46 

25-0ct-79 11:17:46 Never Never LATTA LATTA 
E 

2. Give the FDIRECTORY command for a file, this time requesting 
the only piece of information about current files not 
ordinarily supplied by the command. Ask for a heading also. 

B FDIRECTQRY TE5TF 1 » FOR i 
BE HEADING 
BB CHECKSUM 
BB 

MI SC :< LATTA > 

PGS Bvtes (SZ) 

Write Read Tape- write 

TESTF1 .FOR. 175P7777005A341 1 162(7) 

25-0ct-79 11:17:46 Never Never 
S 


Ret Creation 
Creator Writer Checksum 
1 25-0c t -79 11:17:46 

LATTA LATTA 56G101P 
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Function 


The FORK command specifies the process (fork) of your job to 
which TOPS-20 commands referencing specific processes apply. It 
does not, however, create a process. 


Format 


@FORK (IS) number 
where 

number is the process number, an octal number between 1 and 

777 


Special Cases 


Fork 0 

If you are a user with enabled Wheel privileges you can give 
the command, FORK 0. This references the command processor 
(EXEC) itself. 


Effect on Memory and Terminal 


The FORK command does not affect memory and leaves your terminal 
at TOPS-20 command level. 


Related Commands 

INFORMATION MEMORY-USAGE 

INFORMATION PROGRAM-STATUS 


for examining memory of the 
current process 

for finding out the number and 
status of each process in your job 


Examples 


1. Make the second process of your job the current process. 

B FORK 2 
@ 
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2. Find out which processes exist in your job (an arrow (=>) 
indicates the current process) . Look at memory for the first 
process, then examine a particular location. Make the second 
process current, and do the same thing there. 

e iNFORMATIQN PROGRAM-STATUS 
Used 0 : 0 0 : 0 0 i ri 0 : 0 0 : A G 
T 0 P S - 2 0 : 0:0 0 : 0 0 . G 
SET UUO-SIMULATION (FDR PROGRAM) 

SET CONTROL-C-CAPABILITY (OF PROGRAM) 

= > Fo rk 1 : HALT at 1G176 » 0:00:00.3 

Fork 2: HALT at 472052. 0:00:00.0 
(^INFORMATION MEMORY-USAGE 


1 7 G . p a S e s ) Entry vector 1 o c 2 0 G 1 1 e n 3 


0 

PS : 

< NEXT 

-RELEASE /BASIC. EXE . 2 

1 R . 

CW 

. E 

1 

Private 

R , W . E 




2-G6 

PS : 

< NEXT 

-RELEASE /BASIC. EXE. 2 

3-G7 

R . 

n 

z: 

m 

70-73 

PS : 

< NEXT 

-RELEASE /BASIC. EXE. 2 

70-73 

R 

. CW . E 

74 

Private 

R . W , E 




75-103 

PS : 

•(NEXT 

-RELEASE/BASIC. EXE. 2 

75-103 


^0 

n 

z 

m 

317-321 

Private 

R . W . E 




3G2 

Private 

R . W . E 




370 

Fork 2 

0 R . W , E 




371-372 

No p a 3e 

R . W , E 




373-374 

Fo rk 2 

3-4 R . W , E 




375-437 

No paSe 

R . W . E 




440-526 

PS : 

< NEXT 

-RELEASE/BASOTS . EXE . 2 

1-G7 

R . 

n 

z 

m 

530-532 

Private 

R , W , E 




533-54G 

PS : 

(NEXT 

-RELEASE >BAS0TS . EXE . 2 

71-104 


R . CW , E 

GOO-637 

PS : 

•(NEXT 

-RELEASE/BASOTS . EXE . 2 

105-144 


*3 

n 

z 

m 


H EX AMINE 3500 
3 5 0 0 / 202200..1 136 

6 F0RK 2 

B I NFORMAT I ON MEMORY-USAGE 


108. p a S e 5 » Entry vector 1 o c 401 1 e n 24 


0 

Private 

R . W . E 




3-4 

Private 

R . W . E 




1 0 0 

Private 

R . W . E 




43G-437 

Private 

R . W . E 




4 4 0 - 5 2 G 

Fork 1 

440-526 

R . 

CW , 

E 

527 

No paie 

R . CW , E 




530-532 

Private 

R , W . E 




533-54G 

Fork 1 

533-546 

R . 

CW . 

E 

600-637 

Fo rk 1 

600-637 

R . 

CW , 

E 

G40-7G7 

No pa Se 

R , CW , E 





B EX AMINE 3500 
3500/ 0 

B 
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Function 

The GET commmand places an executable program into memory, 
replacing any existing program. 

Format 

| @GET f ilespec/switch 

where 

filespec is the specification of any file containing an 

executable program 

Default file type - .EXE 

/switch is /USE-SECTION :n 

specifies the memory section (from 0 to 37 
octal) into which your program is to be 
loaded. You can use this switch only if your 
program can be contained in one section. 

Effect of Memory and Terminal 

The GET command clears memory, puts the specified program into 
memory, and leaves your terminal at TOPS-20 command level. 

Related Commands 

INFORMATION MEMORY-USAGE 

LOAD 

MERGE 

SAVE 

START 

Examples 

1. Put an executable program into memory. 

@ GET TESTF1 . EXE 
E 
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for examining the contents of 
memory 

for loading a source or object 
program into memory 

for putting an executable program 
into memory without first clearing 
memory 

for storing a copy of the program 
in memory in a file in executable 
format 

for starting the program in memory 



GET (Cont.) 


2. Verify that you have a magnetic tape drive assigned to your 
job. Get one of your executable programs, save a copy of it 
on tape, and then start it. 

@ INFORMATION AVAILABLE DEVICES 
Devices available to this Job: 

DSK » PSt SNARK . MISC > LANG t REL3 t DX20 , MTAO 
LPT , LPTO t LPT 1 i CDR . PCDRO t CDP » FEO-15 
PTY23-G1 * NUL » PLT » PLTO , DCN * SRV 
Devices assigned to/opened by this Job: M T 0 » T T Y 2 3 0 
B GET TESTF1 
@ SAVE MTO : 

MT0:TESTF1 Saved 
B START 

THIS ISA TEST. 

END OF EXECUTION 

CPU TIME: 0.03 ELAPSED TIME: 0.72 

EXIT 

B 
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Function 


The HELP command gives an explanatory text, at your terminal, of 
many TOPS-20 system features. 


Format 


@HELP name 


where 


name is the name of a system program chosen from the list 

given in response to the command HELP ? 

Default name - HELP 


of HELP Command Arguments 


ACCT20 

COBDDT 

DLUSER 

FORTRA 

MAKLIB 

RERUN 

TRANSL 


ACCTPR 

COBOL 

DUMPER 

HELP 

MARRAM 

RSXFMT 

ULIST 


Sample 


ACTGEN 

CONV20 

EDIT 

ISAM 

MAKVFU 

RUNINP 

USAG20 


APL 

CREF 

FE 

LIBARY 

OPLEAS 

RUNOFF 

USAH20 


APLSF 

DAEMDB 

FILCOM 

LINK 

PLEASE 

SCHEMA 

WATCH 


BLIS10 

DBINFO 

FORDDT 

LPTSPL 

PTYCON 

SORT 


CHECKD 

DBMEND 

FORDML 

MACRO 

QUEUE 

SYSERR 


CHKPNT 

DIRTST 

FORMAT 

MAIL 

RDMAIL 

SYS JOB 


Characteristics 

Other HELP Command Arguments 


Note that some of the HELP command arguments shown here may 
be omitted if the associated programs are not available at 
your site. The list may include other texts inserted by 
your system administrator to describe features special to 
your system. Also, this list is revised frequently to 
reflect improvements and additions to standard TOPS-20 
programs . 


Hints 


Printing HELP Files on the Line Printer 

The texts displayed by the HELP command are stored in system 
logical name HLP: under the name of the program and file 
type .HLP. Use the PRINT command to request your own copy. 


Effect on Memory and Terminal 


The HELP command does not affect memory and leaves your terminal 
at TOPS-20 command level. 
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HELP (Cont.) 


Examples 


1. Ask for information about the FILCOM program, and truncate 
the output with CTRL/Cs. 

B HELP FILCOM 

FILCOM com pares two files in either ASCII mode 

or binary depend ins upon switches or file name extensions. 

All standard binary extensions are recognized as binary by 
default. 

Switches are 

/A compare in ASCII mode 

/ B allow compare of Blank lines 

/ C i Snore Comments and spacing 

/ S 1 Snore SpacinS 

/H type this Help text 

/#L Lower limit for partial compare 

or number of Lines to be matched 
( # represents an octal number) 

/#u Upper limit for pa r t ’ C 

2_c 

@ 

2. Use the DIRECTORY command to search system logical name HLP : 
for any text involving programming language APL. (Note the 
use of wildcard characters here.) Print copies of one such 
file for later use. 

BDIRECTORY HLP : *APL* . HLP 


PS : < HELP > 
APL. HLP. 2 
APLSF . HLP , 2 


Total of 2 files 

S PRINT /L0UIERCASE/C0PIES:3/AFTER: 17:0 0 HL P : A PLSF .HLP 
[Job APLSF Queued » Request - ID 131 . Limit 1 7 21 3 
@ 
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INFORMATION 


Function 

The INFORMATION command reports on system and job parameters. 


Format 

@ INFORMATION (ABOUT) argument 
where 

argument is a keyword, chosen from the list below, indicating 

your choice of INFORMATION command options 


Summary of INFORMATION Command Arguments (defaults in boldface) 


ADDRESS-BREAK 

ALERTS 

ARCHIVE-STATUS filespecs 
ARPANET 


( LINES 

AVAILABLE ( DEVICES 


BATCH-REQUESTS 


/ALL ■ 

/FAST 

/PROCESS ING-NODE : node name 
/USER:user name Default user name 


your user 
name 


COMMAND-LEVEL 
DECNET NODES 


I ALL 
CARDS 

COMPILE-SWITCHES 

PAPER-TAPE 

PLOT 

PRINT 

SUBMIT 

TAKE 


DIRECTORY dev : <d irectory> , 
@ 0VERBOSE 
@ @FAST 
@ 0NAME-ONLY 

DISK-USAGE dev : <d irectory> 


FILE-STATUS octal JFN 
JOB-STATUS 


Default dev : <d irectory> - your 
connected directory 


Default dev : <d i rectory> - your 
connected directory 

Default JFN - all JFNs in your 
j ob 
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LOGICAL-NAMES 


SYSTEM 

JOB 

ALL 

logical 


name : 


MAIL user name Default user name - your user 

name 

MEMORY-USAGE 

MONITOR-STATISTICS 

( /ALL 

OUTPUT-REQUESTS < /FAST 

( /USER:user name Default user name - your user 

name 


PROGRAM-STATUS 

PSI-STATUS 


( /ALL 

RETRIEVAL-REQUESTS < /FAST 

( /USER:user name Default user name - your user 

name 


SPOOLED-OUTPUT-ACTION 

STRUCTURE dev: Default dev: - your connected 

structure 

SUBSYSTEM-STATISTICS 

SYSTEM-STATUS 

TAPE-PARAMETERS 

TERMINAL-MODE number Default number - your terminal 

line number 

VERSION 

VOLUMES 


INFORMATION Command Arguments 

ADDRESS-BREAK gives the location (in numeric or 

symbolic format - depending upon 
previous specification of the SET 
TYPEOUT MODE command) and mode of any 
address breaks for the program currently 
in memory. Set with SET ADDRESS-BREAK. 

ALERTS lists the dates and times that the 

system is to signal you at the terminal. 
The last line of the display indicates 
whether alerts are to be sent 
unconditionally to your terminal 
(depending upon previous specification 
of the SET AUTOMATIC command) . Set with 
SET ALERT. 

ARCHIVE-STATUS filespecs prints the archive status of all 

specified files for which archival has 
been requested or for which migration 
has been prohibited 

Default filespec - *.*.* in your 

connected director 
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INFORMATION Command Arguments (Cont.) 


ARPANET gives this information about the ARPANET 

network, if the system is a member: 

® whether the network service is 
enabled 

9 whether the IMP (Interface Message 
Processor) is up, or down, or 
initializing 

9 date and time of the last ready line 
on-transition (if any) between the 
monitor and the IMP 

® date and time of the last ready line 
off-transition (if any) between the 
monitor and the IMP 


1 


lists the jobs being processed and 
waiting to be processed by the batch 
system. The list includes: 

® the jobname and request ID number of 
the request (an asterisk (*) appears 
before the jobname if the job is 
currently being processed) 

« the scheduled run time of the request 
® the name of the user who initiated 
the request 

» the values of the switches /AFTER and 
/DEPENDENCY-COUNT, if values were 
given in the original SUBMIT or 
subsequent MODIFY command 
Use SUBMIT, MODIFY, or CANCEL, to change 
this list. 

The /ALL switch adds the switches 
/ASSISTANCE, /PRIORITY, /RESTARTABLE , 
/SEQUENCE, and /UNIQUE to this list, 
while /FAST eliminates the display of 
all switches and column headings; 
/PROCESSING-NODE specifies the DECnet 
network node about whose batch jobs you 
want information; /USER restricts 
descriptions to jobs of the user named, 
and can be given with any of the other 
three switches. 

Default user name - your user name 


( LINES 

AVAILABLE (DEVICES lists the devices or terminal lines 

available to you or already assigned to 
your job. Use ASSIGN to obtain devices 
(use MOUNT for structures) . 

Default - DEVICES 

J /ALL 
/FAST 

/PROCESSING-NODE :node name:: 

/USER:user name 
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INFORMATION Command Arguments (Cont.) 


COMMAND-LEVEL prints the status of the 

LATE-CLEAR-TYPEAHEAD parameter, which 
prevents you from giving another TOPS-20 
command until any error message 
resulting from a previous command has 
been printed. Set with SET 
LATE-CLEAR-TYPEAHEAD . 


DECNET NODES 


displays the DECnet network nodes 
accessible to your system. The first 
line provides your local node name. 
Check your current node with INFORMATION 
JOB-STATUS . 


DEFAULTS 


ALL 

CARDS 

COMPILE-SWITCHES 
PAPER-TAPE 
PLOT 


PRINT 

SUBMIT 

TAKE 


displays, in a format suitable for 
entering them, default arguments 
established at the current level of 
TOPS-20 for the specified command. 
CARDS and PAPER-TAPE refer to the PUNCH 
CARDS and PUNCH PAPER-TAPE commands, 
respectively; COMPILE-SWITCHES refers 
to LOAD-class commands. The ALL 
argument displays the defaults for all 
these categories. Set with SET DEFAULT. 

Default - ALL 


DIRECTORY dev : <d i r ectory> , 


@ 0 FAST 
@ 0VERBOSE 
@@NAME-ONLY 


lists the current parameter values set 
for the indicated directory by the SET 
DIRECTORY or BUILD commands, or by 
default. The subcommands call for 
either a short list of non-default 
(i.e., user-determined) values only 
(FAST), or a complete list including 
defaults (VERBOSE), or a listing of 
directory names only (NAME-ONLY). If 
you use NAME-ONLY, specify a directory 
in the form <d i rectory .*> , 
<*directory*> , or <*>. The categories 
of information include: 


9 the directory's password (shown only 
to privileged users or to owner of 
superior directory) 

» working and permanent storage limits 
@ capabilities (assigned or withheld) 

® whether you can establish DECNET or 
ARPANET network connections 
» whether expired files should be 
automa tically archived 
e directory number 
9 default file protection 
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INFORMATION Command Arguments (Cont.) 

9 default account 
9 directory protection 

® default number of generations 
maintained for files 
© maximum number of subdirectories 
allowed 

e date and time of last log-in 
9 off-line and on-line expiration 
defaults 

® group memberships 

9 user group numbers assignable to 
subd i rector ies 

Set with SET DIRECTORY or (for 
subdirectories) BUILD. 

Default dev : <d irectory> - your 

connected 

directory 


DISK-USAGE dev : <d i r ectory> 

prints, for the indicated directory 

® the number of pages of assigned disk 
storage, and the number of deleted 
pages, if any 

© working and permanent page limits 
9 total number of unused pages on the 
file structure containing the 
directory 

Default dev: <directory> - your 

connected 

directory 

You can use percent signs and asterisks 
in the <directory> field (for example, 
<%directory*> , <d i rectory .*> , or <*>) to 
get information about all matching 
directories or subdirectories. 


FILE-STATUS octal JFN 


gives, for the specified JFN (an 
internal number identifying each file 
opening) 

© the associated file specification 
© the mode of access (Append, Execute, 
Read, or Write) for which the JFN is 
open (or was opened last, if NOT 
OPENED precedes the access mode) 

® special access conditions, namely 
DATA ERROR if an error is made in 
accessing the file, or EOF if the 
file pointer is at the end of the 
file 

9 if appropriate, byte pointer and byte 
size, which tell the number of bytes 
transferred to or from the file, and 
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JOB-STATUS 


LOGICAL-NAMES 


MAIL user name 


MEMORY-USAGE 


® a list of devices currently assigned 
to or opened by this job 
But if a file has been opened by another 
process for its sole use, you see only 
the message, "Restricted JFN" . 

Default JFN - all JFNs for your job 

prints yccr 

o job number 
© user name 

• connected directory (if not your 
log-in directory) 

« account; session remark (if any) 
a terminal number 

• network node (if not your host node 
( log-in node) ) 

You can set some of these parameters 
with CONNECT, SET ACCOUNT, SET LOCATION, 
and SET SESSION-REMARK. 


ALL 

JOB 

SYSTEM 

logical name: 

prints the logical names and definitions 
which have been established for your 
job, for the system, or for both; or 
prints the job-wide and system-wide 
definitions of the specified logical 
name. Establish and withdraw logical 
names with DEFINE. 

Default - JOB 

tells whether there is unread mail for 
the user if you have read access to it; 
otherwise you see only the message, 
"Mailbox protected". Send mail with the 
MAIL program, and read mail with the 
RDMAIL program. 

Default user name - your user name 

prints, for the current process of your 
job 

© the number of pages of memory 

assigned 

® location (in numeric or symbolic 

format - depending upon previous 

specification of the SET TYPEOUT MODE 
command) and length of the current 
program's entry vector (set with SET 
ENTRY-VECTOR) 

and on each succeeding line 
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INFORMATION Command Arguments (Cont.) 

e the page numbers of pages occupied by 
a file or program 

e the file specification if the pages 
are file pages; the process 
specification if the pages are mapped 
from another process; PRIVATE 
otherwise . 

• the page numbers of file pages or 

process pages. If a page is mapped 
by indirect pointers, the file 
specification is printed to which it 
is mapped; "Fork n" means that these 
pages are mapped indirectly through 
another process (process n) of the 
job; "No page" can mean either of 
these conditions, when the 

destination page does not yet exist. 

® the permitted accesses to the pages 
(set with SET PAGE-ACCESS) : 

R - Read access 

W - Write access 

CW - Copy-on-Write access 

E - Execute access 

Refer to Example 4 at the end of this 

command description for obtaining 

information on pages assigned to 

extended sections of memory. 

MONITOR-STATISTICS gives you 

e the length of time (in hours, 

minutes, and seconds) since the 

monitor was reloaded 

• an analysis of monitor overhead time, 
by percentages 

• the number of swap-reads and -writes, 
and file-reads and -writes 

e the number of pages of memory 

available to user programs 

• the number of terminal wake-ups 

(occasions when a program "wakes up" 
after waiting for terminal input or 
output to finish) , and of terminal 
interrupts (occasions when a program 
is interrupted by a CTRL/C, CTRL/O, 
or CTRL/T (or other, user-enabled 
control characters) typed at a user's 
terminal ) 
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INFORMATION Command Arguments (Cont.) 


e the average number of processes in 
the balance set (NBAL , a subset of 
the run set - these are runnable, and 
each receives a share of total CPU 
time) and in the remainder of the run 
set (NRUN - these are waiting to be 
run) , 

o the number of seconds of CPU time 
given to each of the four scheduler 
queues (where the leftmost listing 
describes the highest priority queue, 
for interactive processes, and the 
rightmost listing is for CPU-bound 
processes) , and 

• the allotted share and actual use of 
the system (expressed as a percentage 
of total CPU time) by each class, and 
the 1-, 5-, and 15-minute load 

averages of each class 

All averages and totals are computed for 
the time since system start-up. 


( /ALL 

MOUNT-REQUESTS < /FAST 

I /USER:user name 

prints a list, at your terminal, of 
pending structure-mount and tape-mount 
requests, and of tape-mount requests 
currently being satisfied. The list 
includes 

a the volid of each volume of tape that 
will be mounted, or the structure 
identification of each disk pack that 
will be mounted 

a the status of each volume of tape 
(either the number of the tape drive, 


in the form 

, MTAn , 

on which 

i t 

i s 

mounted, or 
a the type of 

Wa i ting ) 
request 

(either 

Disk 

or 

Tape) 

a the mode 

(either 

Enabled , 

if 

the 


/WRITE-ENABLED switch was specified 
or assumed in the original MOUNT TAPE 
command, or Locked if /READ-ONLY 
applies) in which each volume of tape 
is to be mounted 
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INFORMATION Command Arguments (Cont.) 

® the request name (setname) of each 
tape-mount request, or the alias of 
each structure-mount request 
0 the request number (i.e., request ID 
number) of each request 
0 the number of the job that made the 
request 

® the user name of the owner of the job 
that made the request 

Use the MOUNT, CANCEL (for pending 
requests), and DISMOUNT (for satisfied 
requests) commands to change this list. 

The /ALL switch adds the /REMARK switch 
and its argument, if specified in the 
original MOUNT command, and includes the 
first four items above, for tape volumes 
other than the currently mounted volume 
or the first volume specified (in MOUNT 
commands that specify multiple volumes) . 
The /FAST switch eliminates column 
headings and the sum of the number of 
requests; /USER restricts descriptions 
to jobs of the user named, and can be 


given with 
switches . 

either of 

the other 

two 

Default 

user name - 

your user 

name 


( /ALL 

OUTPUT-REQUESTS < /FAST 

( /USER:user name 

prints a listing, at your terminal, of 
the requests being sent or waiting to be 
sent to an output device. The list 
includes 

a the name of the queue (card punch, 
paper tape punch, plotter, or line 
pr inter ) 

® the jobname and request ID number of 
the request (an asterisk (*) appears 
before the jobname if the request is 
currently being processed) 

» the output limit, in appropriate 
units (number of pages, minutes of 
plotter time, feet of paper tape, or 
number of cards) 

e the name of the user who initiated 
the request, and 

® values of the switches /AFTER, 
/FORMS, and /UNIT, if given 
non-default values in the original 
PRINT, PLOT, PUNCH, or subsequent 
MODIFY command 

Use PRINT, PLOT, PUNCH, MODIFY, or 
CANCEL to change this list. 
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INFORMATION Command Arguments (Cont.) 


The /ALL switch adds the /NOTE and 
/SEQUENCE switches to this list, while 
the /FAST switch eliminates the display 
of all switches and column headings; 
/USER res icts descriptions to jobs of 
the user named, and can be given with 
either of the other two switches. 

Default user name - your user name 

PROGRAM-STATUS gives the following information for the 

current level of the TOPS-20 command 
processor (EXEC) : 

« the amount of CPU time you have used, 
and total elapsed time since you 
logged in 

• the amount of TOPS-20 command 
processor time used 

G> SET UUO-S IMULATION (set with SET 
UUO-S IMULATION ) if the TOPS-IO 
compatibility package is enabled to 
simulate TOPS-IO monitor calls issued 
by a program you are running 
® SET CONTROL-C-CAPABILITY (set with 
SET CONTROL-C-CAPABILITY) if your 
program is allowed to handle CTRL/C 
interrupts itself 

© the settings established with the SET 
TRAP and SET TYPEOUT commands 
« a summary of the status of each 
process belonging to the current copy 
of the TOPS-20 command processor, 
including total CPU time used so far 
An arrow (=>) indicates your current 
process . 

PSI-STATUS tells you: 

• whether the PSI (progr ammed-sof tware- 
interrupt) system is in use (ON) or 
not (OFF) 

© the memory address of the level table 
and of the channel table - 0 if none 
was set 

© the numbers of the priority levels 
for which there are interrupts in 
progress (1 and/or 2 and/or 3) , where 
1 is the highest priority 
© the numbers of channels enabled 
(ready) to accept interrupts, and of 
channels with pending interrupts 
For further discussion of the interrupt 
system see the TOPS-20 Monitor Calls 
Reference Manual. 
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INFORMATION Command Arguments (Cont.) 


( /ALL 

RETRIEVAL-REQUESTS < /FAST 

(/USER:user name 

prints a list, at your terminal, of 
pending retrieval requests. Each file 
for which you request retrieval 
constitutes a separate request, even if 
specified within a single RETRIEVE 
command. The list includes: 

e the name of the request (the first 
six characters of the filename) 

® the request ID number 

9 the volids of each tape containing 
the file 

s the name of the user who made the 
request 

The /ALL switch includes the complete 
spec i f icat ion (up to 49 characters of 
the file, while the /FAST switch 
eliminates column headings; /USER 
restricts descriptions to requests of 
the user named and can be used with 
either of the other two switches. 

Default user name - your user name 

SPOOLED-OUTPUT-ACTION tells you whether the system processes 

your spooled output requests 

immediately, or defers them until you 
log out. Set with SET 

SPOOLED-OUTPUT-ACTION. You make spooled 
output requests not with the PLOT, 
PRINT, or PUNCH command (these are 
always processed immediately) , but with 
a command or program that writes files 
to a spooled output device (for example, 
a line printer - LPT:, plotter - PLT : , 
or card punch - CDP:). The COPY 
command, the /LIST switch for LOAD-class 
commands, and the LPT and OUTPUT 
subcommands for DIRECTORY-class and 
SYSTAT commands make spooled output 
requests . 
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INFORMATION Command Arguments (Cont.) 


STRUCTURE dev: 

gives, for each structure named: 

e information as to whether the system 
performs checking operations while 
writing to the data or swapping areas 
of the structure. The system would 
perform this checking by immediately 
reading the data that it has just 
written. If the system manager has 
enabled these functions, the 
following lines appear at the top of 
the display: "Write verification for 
data", and "Write verification for 
swapping " . 

« the number of users who have mounted 
the structure, the number of open 
files on the structure, and the 
number of disks in the structure 

• kind of structure - Public or 
Private, Domestic or Foreign (see the 
TQPS-20 User's Guide ) 

• names of users who have mounted the 
structure 

• names of users who have accessed the 
structure 

9 names of users who have connected to 
the structure 

Use an asterisk (*) for dev: to specify 
all mounted structures. Mount and 
dismount structures with the MOUNT and 
DISMOUNT commands. 

Default dev: - your connected 

structure 

SUBSYSTEM-STATISTICS gives, for each subsystem (any name 

specified by the SETSN JSYS) , the 
following information: 

• its name and total runtime since the 
system last started - SNAMES, STIMES 

o the average number of page faults per 
second it has caused - SPFLTS 
© the number of long-term waits it has 
caused - SNBLKS 

9 its average working-set size (the 
number of pages it occupies in 
memory) - SSIZE 

o the number of times a SETSN JSYS has 
been executed for it (excluding the 
EXEC subsystem) 

See the TQPS-20 Monitor Calls Reference 
Manual for more information. 
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INFORMATION Command Arguments (Cont.) 


SYSTEM-STATUS tells you: 

© whether the operator is present 
® what kinds of log-ins are 
allowed - local, remote, pseudo- 
terminal, network, or console 
« whether accounting (assessing and 
recording charges for system use) is 
being done 

• whether account validation (checking 
accounts against lists of authorized 
users) is enabled 

© whether working set preloading is 
enabled (Working set preloading is 
discussed in the System Manager's 
Gu ide and in the Software 
Installation Guide . ) 

© whether tape-drive allocation 

(automatic assignment of tape drives) 
is enabled 

® whether automatic file 

retrieval-waits (the delaying of a 
command's execution until specified 
off-line files are (automatically) 
retrieved) are enabled 
® the system's expiration default date 
for off-line files 

® the current setting of the scheduler 
bias control. 

® whether class scheduling is enabled, 
and, if it is enabled, the special 
class (if any) for batch jobs, and 
the default class (if any) 

TAPE-PARAMETERS gives the default settings of these 

parameters for magnetic tapes: 

® tape density, in bits per inch 
« tape parity (ODD or EVEN) 
a format (ANSI-ASCII, CORE-DUMP, 

INDUSTRY-COMPATIBLE, or 

SYSTEM-DEFAULT) , and 

• tape record length, in bytes 
Set with SET TAPE." 

TERMINAL-MODE number gives the following information about 

the specified terminal: 

• its type (for example, LA36, VT52, or 
SYSTEM-DEFAULT) 

« its speed (baud rate) , in bits per 
second 

© whether it is set to receive or 
refuse links, advice, and system 
messages 
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VERSION 


INFORMATION Command Arguments 


9 whether it is set to pause in 
printing output when you type the 
pause character, and/or at the end of 
each full page of output 
« the p. se and continue characters 
that you may have set with the 
TERMINAL PAUSE CHARACTER command 
(only if TERMINAL PAUSE END-OF-PAGE 
and TERMINAL PAUSE COMMAND are in 
effect, and if CTRL/S and CTRL/Q were 
not the specified characters) 

® the length (in number of lines) and 
width (in number of characters) of 
its page 

« whether it is capable of printing 
lowercase characters, whether it is 
set to raise lowercase letters you 
type to uppercase, and whether it 
will mark (flag) capital letters with 
a single quotation mark (') 

« whether it has a formfeed mechanism, 
and whether it is set to only 
indicate formfeeds or to perform them 
o whether it has mechanical tab stops, 
whether it is set to immediately echo 
input you type 

» whether it is operating in FULLDUPLEX 
or HALFDUPLEX mode 

Set with TERMINAL. The SYSTAT command 
displays terminal numbers. 

tells you: 

» the TOPS- 2 0 operating system's name 
and version number 

o the version of the TOPS-20 command 
processor in use 

« the names (and versions, if any) of 
all programs currently in memory for 
which program data vectors (PDVs) 
exist and that are associated with 
the current process. (Refer to the 
Monitor Calls Reference Manual and to 
the description of the /PVBLOCK 
switch in the LINK Reference Manual 
for information on PDVs.) See 
Example 5. 

© the version of the UUO simulation 
package in use (if a TOPS-IO program 
is in memory) 

The format of a version number is: 
a .b (c) -d 
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INFORMATION Command Arguments (cont.) 


where: (1) a and b are respectively 

incremented for major and minor changes 
in the software (2) c gives a rough 
indication of the number of times the 
software component has been edited (3) 
d, a holdover from earlier versions of 
TOPs-20 and is now rarely used, 
identifies the programmer (s) , 

responsible for the software component. 

VOLUMES setname: gives the volids of currently mounted 

and newly created volumes in the 
specified tape set 


Hints 


Specifying the Correct Process of TOPS-20 

Use the FORK command to specify the process to be described 
by the ADDRESS-BREAK, FILE-STATUS, and MEMORY-USAGE 
arguments. Find out your current process with INFORMATION 
PROGRAM-STATUS. 


Effect on Memory and Terminal 


The INFORMATION command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Examples 


1. Use an INFORMATION command to determine your current terminal 
settings . 

@ INFORMATION TERM I NAL-MDDE 
TERMINAL LA3G 
TERMINAL SPEED 300 
REFUSE LINKS 
REFUSE ADO ICE 
RECEIVE SYSTEM-MESSAGES 
TERMINAL PAUSE (ON) COMMAND 
TERMINAL PAUSE (ON) END-OF-PAGE 
TERMINAL PAUSE (ON) CHARACTER SPACE 
TERMINAL LENGTH SB 
TERMINAL WIDTH 80 
TERMINAL LOWERCASE 
TERMINAL RAISE 
TERMINAL NO FLAG 
TERMINAL INDICATE 
TERMINAL NO FORMFEED 
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TERMINAL NO TABS 
TERMINAL NO IMMEDIATE 
TERMINAL FULLDUPLEX 

@ 

2. Mount a structure and access your directory on the structure. 
Compare the disk space available in this directory and in 
your connected directory. (Note that there are many more 
pages free on your connected structure (MISC:) as a whole 
than on structure SNARK:; this is likely to make your use of 
the system more efficient if you work only within MISC:.) 

B MOUNT STRUCTURE SNARK: 

Structure SNARK: mounted 

B ACCESS SNARK : 

@ I NFDRMAT I DN DISK-USAGE SNARK: 

SNARK :<LATTA> 1 

198 PaSes assigned 

400 Working pases i 400 Permanent eases allowed 
2836 Pages free on SNARK: 

B I NFDRMAT I ON DISK-USAGE 

MISC: < LATT A > 0 

119 Pages ass i Sued 

590 Working paies i 590 Permanent pages allowed 
33172 Pages free on MISC: 

@ 

3. Print a file, ordering several copies and supplying a note to 
be attached to it. Use an INFORMATION command to verify that 
your request is in the output queue. Modify the date on 
which the job will be printed, and use the INFORMATION 
command again to confirm this action. 

@ PR I NT TESTF1 .FOR /AFTER: 1 7 : 00 / COP I E5 : 20 / FORMS : N ARROW / NO - 

TE : "T-TH LAB" 

[Job TESTF1 Queued , Resuest-ID 219 * Limit 541 

@ I NFORMAT I ON PUT P U T - R E QUE S T 5 /ALL/USER 

Printer Queue: 

Job Name Res* Limit User 


TESTF1 219 54 LATTA / F o rm s : NARROW 

/After: 8-No u -79 17:00 /Note:T-TH LAB /Sea: 1791 
There is 1 Job in the Queue (None in Progress) 

B MODIFY PRINT 219 /AFTER; 15-ND0-79 17:00 
Cl Job Modified] 

@ I NFORMAT ION PUT PUT. - REQUESTS /ALL/USER 
Printer Queue: 

Job Name R e a » Limit User 

TESTF1 219 54 LATTA /Fo rms : NARROW 

/After: 15-No v -79 17:00 /Note:T-THLAB / S e a : 1 7 9 1 

There is 1 Job in the Queue (None in Progress) 

@ 
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4. Place a program in memory section 17. Then give the 

INFORMATION MEMORY-USAGE command to verify that the program 
was appropriately placed. The page numbers, beginning at 

17000, indicate that section 17 is in use, because a section 
comprises 1000 (octal) pages. Also, the left half of the 
entry vector location contains 17. 

6 GET TEST , EXE , 1 / USE - SECT I ON i 1 7 
@ INFORMATION (ABOUT) MEMORY-USAGE 

2 . pajes i Entry vector 1 o c 170001B2 1 e n 254000 

17000-17001 TEST .EXE. 1 1-2 R . CW , E 

B 

5. Issue the INFORMATION VERSION command for information on 

programs in your memory area that have program data vectors 
associated with them. Note that the merging of such programs 
yields consolidated information. 

@ GET IQLIB 

B I NFQRMAT I ON VERSION 

2102 T 0 P S - 2 0 Development System . T 0 P S - 2 0 Monitor 5(4204) 
T0PS-20 Command processor 6(717) 

Program is I0LIB 

P D 0 s : Proiram name I 0 P A K » version 1.1(420) 

@ 

@ GET MATHLB 
e iNFORMATION VERSION 

2102 T 0 P S - 2 0 Development System. T 0 P S - 2 0 Monitor 5(4204) 
T0PS-20 Command processor 6(717) 

Program is MATHLB 

PD 0s : Program name MATHLB » version 3.33(360) 

@ 

E MERGE IQLIB 
B I NFQRMAT I ON 0ERSI0N 

210 2 T □ P S - 2 0 Development System. T 0 P S - 2 0 Monitor 5(4204) 
T0PS-20 Command processor 6(717) 

Program is MATHLB 

PDOs : P ro 3 ram name MATHLB » version 3 . 33 ( 360 ) 

Proiram name I O P A K . version 1.1(420) 

@ 

B MERGE RPTGEN 
6 I NFQRMAT I ON VERSION 

2102 TO PS -20 Development System. TO PS -20 Monitor 5(4204) 

T 0 P S - 2 0 Command processor 6(717) 

Proiram is MATHLB 

PDOs: P r o 3 r a m name REPORT » version 3.1(156) 

P r o 3 r a m name MATHLB. version 3.33(360) 

P r o 3 r a m n a m e 1 0 P A K » version 1.1(420) 

B 
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Function 

The LOAD command loads your program into memory, compiling the 
source file first if necessary. 


Format 


@LOAD (FROM) /switch (es) source/switch (es) object,... 


switches 


source 


object 


are keywords chosen from the list below, 
indicating your choice of LOAD command options. 
They have different effects depending on their 
position in the command line: placed before all 
files in the command, they act as defaults for 
all; otherwise they affect only the nearest 
preceding file. 

Defaults are shown in the list of switches 

is the file specification of the source program. 
The filename must be of 6 or fewer characters, and 
the file type of 3 or fewer characters; you 
cannot use a generation number. This argument is 
not necessary if you supply an object filespec. 

is the file specification of the object program. 
The filename must be of 6 or fewer characters, and 
the file type must be .REL; you cannot use a 
generation number. This argument is not necessary 
if you supply a source filespec. 

Default (if you give neither source nor 
object filespecs) - last filespecs 
and associated switches you gave in a 
LOAD-class command 


means that, after a comma, you can give more 
arguments (source, switches, and object) of the 
form already shown 


Summary of LOAD Command Switches (defaults in boldface) 

/ 6 8-C0B0L 

/74-COBOL 

/ALGOL 

/COBOL 

/COMPILE 

/CREF 

/DDT 

/DEBUG 

/FORTRAN 

/LANGUAGE-SWITCHES : "/switch (es) " 

/LIBRARY 

/LIST 

/MACRO 

/MAP 
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/NOCOMPILE 

/NODEBUG 

/NOLIBRARY 

/NOLIST 

/NOOPTIMIZE 

/NOSEARCH 

/NOSYMBOLS 

/OPTIMIZE 

/RELOCATABLE 

/SEARCH 

/STAY 

/SYMBOLS 

Descriptions of these switches are given below. Although the 
system accepts switches described under any of the LOAD-class 
commands, only those switches commonly associated with LOAD are 
described here. 


/ 6 8-COBOL 

/74-COBOL 

/ALGOL 

/COBOL 

/COMPILE 

/CREF 


/DDT 

/DEBUG 


LOAD Command Switches 

compiles the file using the COBOL-68 
compiler 

Default for files of type . CBL 

compiles the file using the COBOL-74 
compiler 

compiles the file using the ALGOL 
compiler 

compiles the file using the COBOL-68 
compiler 

forces compilation of the source file 
even if a current object file already 
exists. Use this switch along with a 
/LIST or /CREF switch to obtain listings 
when you have current object files. 

creates a file containing 

cross-reference information for each 
compilation. The filename is that of 
the object file; the file type is . CRF . 
Use the CREF command to obtain a listing 
of the file. (For COBOL files, the 
switch automatically produces a 
cross-reference listing.) See the 
TOPS-20 User Utilities Guide for more 
information about the CREF program. 

loads the DDT debugging program along 
with your object file 

produces an object file containing 
debugging information beyond that 
usually provided during a compilation 
(for use with FORTRAN programs only, and 
only if you have not given the /OPTIMIZE 
switch) 
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LOAD Command Switches (Cont.) 

/FORTRAN compiles the file using the FORTRAN 

compiler 

Default for switches specifying 
compiler language, in the 
absence of a standard source 
file type 

/LANGUAGE-SWITCHES : " /swi tch ( es ) " 

passes the specified switches to the compiler 
that will process the file(s) to which the 
switch applies. You must include the switches 
in double quotation marks (" "). 

/LIBRARY same as /SEARCH 

/LIST prints a line printer listing of the program in 

ASCII format. The name of this listing is the 
filename of the object file. The /CREF switch 
overrides /LIST when they both apply to the 
same file. 

/MACRO assembles the file using the MACRO assembler 

/MAP produces a loader map and stores it in the file 

object. MAP, where object is the name of the 
module containing the start address; or (if no 
start address) nnnLNK.MAP, where nnn is your 
job number 

/NOCOMPILE prevents compilation if the associated object 

file is current; otherwise it forces 
compilation. The switch is useful chiefly in 
canceling a /COMPILE or /RELOCATABLE switch. 
Default 

/NODEBUG excludes special debugging information from 

your object file 
Default 

/NOLIBRARY same as /NOSEARCH 

/NOLIST prevents a line printer listing of the program 

Default 

/NOOPTIMIZE prevents the generation of a globally optimized 

object file (for FORTRAN programs only) 

Default 

/NOSEARCH requires all modules in the object file library 

(the file accompanied by this switch in the 
command line) to be loaded even if they are not 
called by your program. Use this switch to 
cancel a /SEARCH switch. 

Default 
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LOAD Command Switches (Cont.) 


/NOSYMBOLS 

/OPTIMIZE 


/RELOCATABLE 


/SEARCH 


/STAY 


/SYMBOLS 


prevents a symbol table from being 
loaded along with the object file 

calls for generation of a globally 
optimized object file, that is, one that 
runs as quickly as possible (for FORTRAN 
programs only, and only if you do not 
also give the /DEBUG switch) 

prevents compilation of the source file, 
forcing use of an existing object file 
even if the object file is out of date 

requires that the object file library 
(the file accompanied by this switch in 
the command line) be searched for 
modules called by your program or by a 
program subroutine. Only these modules 
are loaded, along with modules called 
from the system libraries, which are 
always searched. 

returns your terminal to TOPS-20 command 
level so that you can perform other work 
while the system continues to load your 
program. You immediately receive the 
TOPS-20 prompt (@ or $) , and can then 
issue any user command. But be careful 
with commands that run' programs, because 
those commands may clear memory and 
terminate the current process. Also, 
you could easily send incorrect data to 
programs expecting terminal input. This 
switch saves you from having to: issue 
a "T to make sure loading has begun; 
give a *C to halt the job; and issue a 
CONTINUE STAY command to remain at 
command level during loading. 

loads a symbol table along with the 
object file; helpful for debugging a 
program 

Default 


Characteristics 

Compiling New Sources Only 

Before loading programs, the system ordinarily compiles any 
specified source (and only those sources) whose write date 
is more recent than that of the object file of the same 
name. You can override this action with the /COMPILE or 
/RELOCATABLE switch. 
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Using Standard File Types 

If you specify source files with standard types (.FOR, .MAC, 
. CBL , or .ALG) in a LOAD command, the system automatically 
calls the appropriate compiler when compilation is 
necessary. If you specify source files by filename only, 
the system searches your connected directory for a file of 
this name and a standard type. To load programs from 
sources that have nonstandard file types, give a switch to 
indicate the proper compiler (/FORTRAN, /MACRO, /COBOL, or 
/ALGOL) . A switch will take precedence over a standard file 
type if they indicate different languages. If no compiler 
is indicated with either a switch or a standard file type, 
the FORTRAN compiler is used. 


Hints 


Commas Between Filespecs 

If you give two or more filespecs separated by commas as 
arguments to LOAD, the loaded programs exist in memory at 
the same time and will operate as a single program. You can 
use this feature to substitute one module for another under 
varying conditions or for different applications. 

Plus Signs Between Filespecs 

If you give two or more source filespecs separated by plus 
signs (+) as arguments to LOAD, they are compiled together 
as if they were a single file. Their object module is 
stored under any filename given as the "object" argument of 
the command, or (if none) under the last filename in the 
group and file type .REL. 


Indirect Files as Arguments 


You can store arguments (source and object 
switches) of a LOAD command in an indirect file, 
them by typing an at sign (@) and its filespec 
command argument. 


filespecs , 
and specify 
as a LOAD 


Establishing Default Arguments with the SET Command 

You can issue the SET DEFAULT COMPILE-SWITCHES command to 
set up default global arguments to the LOAD command. Insert 
this SET command in your COMAND.CMD file to change your own 
defaults permanently. 


Running Link Directly 

The LOAD command automatically runs LINK, the system's 
loader program, but if you require more control of the 
loading process you can run LINK directly. See the TQPS-20 
LINK Reference Manual. 
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Using GET Instead of LOAD 

If you have used the SAVE command to save your programs in 
executable format, you can use the GET command instead of 
LOAD to place them in memory. This is a faster and less 
expensive means of loading programs into memory. 


Restrictions 

Switches Requiring Compilation 

/CREF 

/DEBUG 

/LANGUAGE-SWITCHES 

/LIST 

/NODEBUG 

/NOLIST 

/NOOPTIMIZE 

/OPTIMIZE 

The above switches will not take effect unless the LOAD 
command causes a new compilation of the relevant source 
file. See Characteristics - Compiling New Sources Only, 
above, for more information. 

Warning - Generation Numbers, Long Filespecs 

You must not give generation numbers when specifying source or 
object files; the system automatically uses the highest 

generation. Also, most compilers require filenames of 6 or fewer 
characters and file types of 3 or fewer characters. 


Effect on Memory and Terminal 

The LOAD command clears memory and loads your program. It leaves 
your terminal at TOPS-20 command level. 


Related Commands 

COMPILE, EXECUTE, and DEBUG 

SAVE 

START 

SET DEFAULT COMPILE-SWITCHES 


other LOAD-class 
commands for performing 
related functions 

for saving the loaded 
program in an .EXE file 

for starting the loaded 
program 

for establishing 
default switches for 
LOAD-class commands 
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INFORMATION DEFAULTS COMPILE-SWITCHES for examining default 

switches established 
for LOAD-class commands 


Examples 

1. Load an object file into memory. 

B LOAD LST5Q . REL 
LINK: LOADING 

EXIT 

e 


2. Load the same program, allowing the system to update the 
object file if necessary. 

B LOAD LSTSQ/FQRTRAN 
FORTRAN: LSTSQ 
MAIN. 

LINK: LOADING 

EXIT 

@ 

3. Load a MACRO program and request a loader map or memory map. 
(Notice the filename of this map.) 

B LOAD TEST2/MAP 
MACRO: FT 
LINK: LOADING 

EXIT 

B TDIRECTORY 

WRITE 


PS : < LATTA > 

FT. MAP. 1 G-APR-78 15:23: 17 

TEST2.REL 
B 

4. Load a COBOL program, forcing a new compilation that includes 
only the required modules. Request a map. 

B LOAD /MAP TESTI/COMPILE t COB L I B / SE A RCH 
COBOL: DBL CTESTl.CBL] 

LINK: LOADING 

EXIT 

B 
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5. Compile a program. Then load it, requesting a 
cross-reference listing this time. Finally, save the program 
in executable format. 

B CQMPILE TESTI/COBOL 
COBOL: DBL [ TEST 1 . CBL ] 

B LQ AD /COMPILE/CREF 
COBOL: DBL [TEST 1. CBL] 

LINK: LOADING 

EXIT 

B SAVE 

TEST 1 .EXE. 1 SAVED 
B 


6. Combine two FORTRAN sources into an object program under a 
new name. Start this program. 

B LOAD LSTSQ+ABRR REGRE5 

FORTRAN: LSTSQ 

MAIN. 

MAIN. 

LINK: LOADING 

EXIT 
@ ST ART 
@ 


7. Create an indirect file, and use it to load several modules 
at once. Request cross-reference files, then give the CREF 
command to turn these into listings. 

B CREATE SERVTT.CMD 
INPUT: PS:SERV TT.CMD.l 
0 0 1 0 0 HJRAD/COMPILE > FORL I B / SE A RCH 
0 0 2 0 0 HJVTT/COMPILE , FORL I B / SEARCH 
0 0 3 0 0 HJINI /RELOCATABLE 
0 0 4 0 0 $ 

*E 

[SERVTT.CMD. 1] 

B LOAD /CREF BSERVTT.CMD 

FORTRAN: H JR AD 

MAIN. 

FORTRAN: HJVTT 
MAIN. 

LINK: LOADING 

EXIT 

B CREF 

CREF: HJRAD 

CREF: HJVTT 

B 
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Function 

The LOGIN command validates you as a user, and CONNECTS your job 
to and ACCESSes your log-in directory. 


Format 

@ LOGIN (USER) name (PASSWORD) pwd (ACCOUNT) acc (SESSION REMARK) remark 


where 

name 

pwd 


acc 


remark 


Output 

Notice of User Mail, and System Mail 

After the system acknowledges a valid LOGIN command by 
printing your job number, terminal number, and the current 
date and time, it informs you if another user has sent you a 
message by means of the system mail programs. Then system § 
mail (mail sent by privileged users to all users) that has 
accumulated since your last log-in is displayed on your 
terminal. Note however, that this mail appears in the log 
file if a batch job is run for you between the time the mail 
is sent and the time you log in. 


Characteristics 

Typing an Initial CTRL/C 

Before logging in you may have to type a CTRL/C or carriage 
return (which will print the system herald or greeting) to 
get the @ prompt necessary for typing the LOGIN command. If 
you are dialing in by telephone to a line declared autobaud 
by the system manager, this initial CTRL/C or a carriage 
return will enable the system to determine your terminal's 
speed setting, as long as the speed is either 110, 150, or 

300 . 


is your user name 

is your secret password (which is not printed on 
your terminal) 

is an account name or number that you are authorized 
to use 

is an optional comment of 39 or fewer characters, 
describing the coming terminal session 
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Rights, Capabilities, and Charges 

The LOGIN command gives you ownership rights to your log-in 
directory, and any group rights established for you on the 
public structure (usually named PS:). In addition, you are 
granted whatever capabilities (for example. Maintenance, 
Wheel) have been awarded to you, and can be sure that any 
charges you incur for the use of system resources, such as 
CPU time or the batch and printing systems, will be billed 
to your user name. 


Hints 


Commands in Files Executed at Log-in Time 

TERMINAL Commands 

If you have commands in a your LOGIN.CMD file in your 
log-in directory that control terminal output (e.g., 
TERMINAL PAUSE or TERMINAL LENGTH) , be sure to put them 
before the first command that runs a program. Then 
they will be in effect when system mail is displayed. 

For Affecting Entire Session or Current Level Only 

As soon as you log in, the system executes the commands 
contained in your LOGIN.CMD file and then your 
COMAND.CMD file in your log-in directory. Commands 
that affect your entire job, for example, TERMINAL and 
DEFINE, belong in LOGIN.CMD. Commands that affect only 
the current level of TOPS-20, for example, many SET 
commands, must be put into COMAND.CMD if you want them 
to be executed automatically after every PUSH command 
as well as after LOGIN. 

For Affecting Batch Jobs 

As soon as one of your batch jobs logs in, the system 
executes the commands contained in your BATCH.CMD file 
and then your COMAND.CMD file in your log-in directory. 
Note that certain parameters of the batch job, for 
example, its time limit and the name of its log file, — 
have already been set before these commands are 
executed. Such parameters are set either to values 
specified by switches in the SUBMIT command that starts 
the batch job, or to default values in effect for the 
job issuing this SUBMIT command. See also Hints - For 
Affecting Nested Batch Jobs, below. 
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For Affecting Nested Batch Jobs 

By placing a SET DEFAULT SUBMIT command in a file of 
specification BATCH.CMD in your log-in directory, you 
cause these defaults to be in effect for a nested batch 
job, i.e., a batch job started by a SUBMIT command 
within the control file of another of your batch jobs. 
Note that if the control file contains a PUSH command 
before the SUBMIT, any SET DEFAULT SUBMIT command in a 
file of specification COMAND.CMD in your log-in 
directory will be in effect instead, because commands 
in COMAND.CMD are executed after every PUSH command as 
well as at log-in time. 

A Final TAKE Command 

To avoid display of a message of the form, "End of 
file.CMD" after execution of a command file, make the 
last command in such a file a TAKE command with no 
arguments . 

Simplifying Log-ins 

By using the SET DIRECTORY ACCOUNT-DEFAULT command you 
cause subsequent LOGIN commands to require just your 
user name and password. 


Special Cases 


Commands You Can Issue Before Log-in 

You can give these commands before logging in: 


ATTACH 

BREAK with arguments: 


DAYTIME 

INFORMATION 


LOGOUT 

SET 

SYSTAT 

TERMINAL 

UNATTACH 


AVAILABLE 

COMMAND-LEVEL 

MAIL 

TERMINAL-MODE 

VERSION 

LATE-CLEAR-TYPAHEAD 

TIME-LIMIT 

(except with subcommands LPT or OUTPUT) 
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Logging in to PTYs 

You do not need to give a password when logging in under 
your own user name to a PTY (pseudo-terminal) . 

Must Log In Within Five Minutes 

If you do not log in within five minutes of your initial 
CTRL/C, your job will be logged out automatically and you 
will have to type CTRL/C again. 

Logging in to Last Available Job Slot 

If you attempt to log in to the last available job slot, the 
system will not log you in but will send you an error 
message instead. This job slot is intended for users who 
wish to attach detached jobs using the ATTACH command. To 
log in a new job you must wait until a current user logs 
out . 


Effect on Memory and Terminal 


The LOGIN command does not affect memory and leaves 
at TOPS-20 command level. However, commands in 
executed during log-in (see Hints, above) will have 
effect on memory and your terminal. 


your terminal 
command files 
their usual 


Related Commands 


ATTACH, 

LOGOUT 
SET ACCOUNT 

SET DIRECTORY ACCOUNT-DEFAULT 

SET SESSION-REMARK 


for joining to your terminal a 
job that has already been 
logged in 

for ending your timesharing job 

for changing your account 
during a terminal session 

for specifying a default 
account for subseguent log-ins 

for making or changing your 
session remark during a 
terminal session 
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Examples 


1. Log in, using account 341. 

B LOG I N C . RYDER 341 
Job 39 on TTY41 8-May -79 11:04:21 

@ 

2. Type a CTRL/C to get the TOPS-20 greeting, then log in, using 
account 341 and inserting a session remark. _ Give INFORMATION 
JOB as your first command, to see this session remark. 

SYSTEM 2102 DEUELOPMENT SYSTEM , T0PS-20 Monito r 4(3212) 

B LOGIN URQUHART 341 TEST -REMARK 
Job 42 on TTY29 8 -May -79 9:15:15 
End of LOGIN . CMD . 1 
B INFQRMATION JOB 

Job 42 , User URQUHART , Account 341 » TTY29 
Session remark : TEST-REMARK 
0 
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Function 


The LOGOUT command ends a timesharing job. 


Format 


@ LOGOUT n 
where 

n is an optional job number. Specify n only when logging out 

a job other than your attached job. 


Output 


System Use Under Current Account 

The system acknowledges a valid LOGOUT command by printing 
your job number, user name, current account, terminal 
number, and the current date and time. Then it shows the 
total amount of CPU time you used during the terminal 
session and the total length of time you were logged in, 
followed by the amount of CPU time used under the current 
account and the length of time you were logged in under this 
account. 


Characteristics 


Expunging Your Log— in and Connected Directories 

Before logging you out, the system expunges any deleted 
files from your log-in and connected directories, and prints 
a message if either directory is still exceeding its 
assigned permanent disk quota. 

Logging Out Other Jobs 

By specifying a job number you can log out any other job 
logged in under the same user name as your attached job. By 
specifying a job number, a user with Wheel or Operator 
capabilities enabled can log out any job other than his 
attached job. 


Effect on Memory and Terminal 


The LOGOUT command clears memory and leaves your terminal in the 
state before log-in. LOGOUT n does not affect memory and leaves 
your terminal at TOPS-20 command level. 
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Related Commands 


DETACH 

for disengaging a 
ending the job 

job from your 

terminal 

without 

LOGIN 

for beginning your 

timesharing job 



UNATTACH 

for disengaging a 

J 1 U „ • ~ u 

job from another 

terminal 

without 


ending the job 


Examples 


1. Log out your job. 

B LOGDUT 

Killed Job 18i User C. RYDER , Account 341 , TTY 233 , 
at 8 - M a y - 7 9 18:25:48 , Used 0:0:5 in 1:2:18 

2. Log out your job, receiving a warning message that your 
directory is over its storage quota. 

B LQGQUT 

< U R 0 U H A R T > 0 u e r permanent storage allocation by 8 paSe(s) . 
Killed Job 39 , User URQUHART > Account 341 , TTY 41 
at 8-May-79 18:33: 12 » Used 0:0:1 in 0:1:58 

3. Check what jobs are logged in under your user name. Log out 
a detached job and verify that it is gone, then log out your 
attached job. 

B SYSTAT LATTA 

39 DET EXEC LATTA 

43* 228 EXEC LATTA 

B LOGDUT 39 
B SYSTAT LATTA 

43* 228 EXEC LATTA 

B LOGQUT 

Killed Job 43, User LATTA, Account 341 , TTY 228, 
at 8-May -79 18:35:18, Used 0:0:1 in 0:1:1 
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Function 


The MERGE command places an executable program into memory, 
combining it with whatever program (if any) is already there. 

Format 


@MERGE f ilespec/swi tch 
where 

filespec is the file specification of any executable program 

Default file type - .EXE 

/switch is /USE- SECT I ON :n 

specifies the memory section (from 0 to 37 
octal) into which your program is to be 
merged. You can use this switch only if your 
program can be contained in one section. 


Characteristics 


Executable Files Only 

If a program you try to merge is not in executable format, 
you may get an immediate error message (that is, 
" 7UNEXPECTED END-OF-FILE TRAP...") or a delayed one (that 
is, " 7ENTRY VECTOR LENGTH IS NOT LESS THAN 1000") after the 
merge. In either case, be sure that you have specified an 
executable program before investigating further. The MERGE 
command does not alter the entry vector if the file being 
merged is in the proper .EXE format. 

Page Overlays 

If there is a program already in memory when you give the 
MERGE command, it will remain intact unless some pages of 
the new program overlay it. In such a case the new pages 
replace the old. However, if the file being merged was 
created by a CSAVE command, the merge and any replacements 
occur on a word-for-word basis, rather than page for page. 


Examples 


1. Merge an executable program into memory. 

B MERGE TESTF1 , EXE 
@ 


} 
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Place an executable system program in memory, then merge a 
system debugging program with it. Give INFORMATION 
MEMORY-USAGE commands to verify that both programs are 
intact . 


@ GET SYSiDUMPER 
@ I NFQRMftT I ON MEMORY - USftGE 

18. p a 3 e s t Entry uector 1 o c 3 0 B 7 1 e n 3 

0 PS:<NEXT-RELEASE> DUMPER. EXE.l 1 R t CW > E 

3-23 PS: <NEXT-RELEASE> DUMPER. EXE.l 2-22 R. CW i E 


6 MERGE S Y S : U D D T 
e iNFQRMATIQN MEMORY-USAGE 

25. p a S e s » Entry vector 1 o c 3 0 B 7 1 e n 3 


0 PS:<NEXT-RELEASE> DUMPER. EXE. 1 
3-23 PS:<NEXT-RELEASE> DUMPER. EXE. 1 
770-77B PS:<LOADTEST>UDDT .EXE, 7 1-7 


1 R . CW . E 
2-22 R. CW . E 
R , CW . E 



MODIFY 


Function 


The MODIFY command adds or changes switches for a request placed 
in a batch or output queue. 


Format 


@MODIFY (REQUEST TYPE) queue (ID) identifier /switch (es) 
where 

queue is the waiting list in which you placed the original 

request, chosen from the following list: 


BATCH 

for requests made 
command 

using 

the 

SUBMIT 

CARDS 

for requests made 
CARDS command 

using 

the 

PUNCH 

PAPER-TAPE 

for requests made 
PAPER-TAPE command 

using 

the 

PUNCH 

PLOT 

for requests made 
command 

using 

the 

PLOT 

PRINT 

for requests made 
command 

using 

the 

PRINT 


In the switch summary and descriptions, the word 
Output in the column headed Applicable Queues means 
all queues except the batch queue. 


identifier is one of the following: 

request ID number the unique identifier assigned by 

the system to your request. This 
is the number appearing under the 
heading "Req#" in the list of 
requests shown by the INFORMATION 
BATCH-REQUESTS or INFORMATION 
OUTPUT-REQUESTS command. 

jobname the jobname of the request, either 

the first six characters of the 
first filename in the request, or 
the argument you supplied to a 
/JOBNAME switch when making the 
original request. This is the name 
appearing under the heading "Job 
Name" in the list of requests shown 
by the INFORMATION BATCH-REQUESTS 
or INFORMATION OUTPUT-REQUESTS 
command . 
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/JOBNAME : jobname switch showing the jobname of the 

request to modify. You can specify 
a particular jobname when making 
the original request. See Special 
Cases - /JOBNAME Switch, below. 

/SEQUENCE : sequence number 

switch showing the sequence number 
of the request to modify. You can 
specify a particular sequence 
number when making the original 
request . 

Use an asterisk (*) as identifier to modify all your 
requests in the specified queue. 


/switches are keywords, chosen from the list 

below, specifying the parameter you want 
to change (and, where applicable, the 
new value of this parameter) 


Summary of MODIFY Command Switches 


Switch 


Applicable Queues 


/AFTER:date and/or time 



All 

/BEGIN : n 



All 

/CARDS :n 


BATCH 


/COPIES : n 



Output 

/DELETE 



Output 

/DEPENDENCY-COUNT: n 


BATCH 


/DESTINATION-NODE : node name:: 



All 

/FEET: n 


BATCH 


ASCII 

PRINT 



COBOL 

PRINT 



/FILE: ELEVEN 

PRINT 



FORTRAN 

PRINT 



/FORMS: forms name 



Output 

/GENERIC 



Output 

/HEADER 



Output 

/JOBNAME : jobname 


BATCH, 

Output 


/LIMIT: n PRINT 

/LOWERCASE PRINT 


/MODE: output mode 
/NOHEADER 

/NOTE : 12-char acter message 
/PAGES :n 
/PRIORITY : n 

/PROCESSING-NODE : node name 
/REPORT: title 


PRINT 


BATCH 

BATCH 


Output 

Output 

Output 

All 


NO 

/RESTARTABLE : YES 


BATCH 


189 



MODIFY (Cont.) 


Summary of MODIFY Command Switches (Cont.) 


Switch 


Applicable Queues 


/SEQUENCE :n 

SINGLE 
/SPACING: DOUBLE 
TRIPLE 

/TIME : hh : mm : ss 
/TPLOT : n 

0 or NO 

/UNIQUE:! or YES 


All 


PRINT 


All 

BATCH 

BATCH 


/UNIT:octal number 
/UPPERCASE 
/USER:user name 


PRINT 


Output 

All 


MODIFY Command Switches 


Applicable Queues 


/AFTER:date and/or time, or 

day of week (or TODAY) 
and/or time 


All ensures that the request 
will not be processed 
until after the revised 
date and/or time 

specified. NOV-12-79, 
and 18:00 illustrate two 
arguments to this 

switch. If you give 
both date and time, 
separate them with a 
space. When given 

alone, the time may be 
preceded by a plus sign 
(+) , which will delay 
processing by the 

indicated length of time 
from the present. 

Alternatively, you can 
give a day of the week 
(e.g., MONDAY) or TODAY 
as argument; then the 
job will not be printed 
until the beginning of 
the following day. If 
you follow this argument 
with a plus sign and a 
time, the job will be 
further delayed by this 
amount . 
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MODIFY Command Switches (Cont.) 


/BEGIN : n 


/CARDS :n BATCH 

/COPIES : n 
/DELETE 

/DEPENDENCY-COUNT : n BATCH 


All gives the decimal line 
number of the control 
file at which processing 
is to begin (for BATCH) , 
or the decimal page 
number of the file at 
which the output is to 
begin (for CARDS, 

PAPER-TAPE, PLOT, and 
PRINT) 

specifies the decimal 
number of spooled cards 
the job is allowed to 
punch 

Output tells how many copies of 
the file to produce 

Output deletes the file after 
processing 

sets the request's 
dependency count to the 
new value n. This 
switch can also be 
followed by a signed 
value, i.e., +n or -n, 
which will increase or 
decrease the old value 
by the specified amount. 
A batch request is not 
processed until its 
dependency count is 0. 
See the TQPS-10/20 Batch 
Reference Manual for 
more information about 
dependency counts. 


/DESTINATION-NODE : node name:: 


All specifies the DECnet 
network node on whose 
line printer the log 
file of your batch job 
is to be printed (for 
BATCH) , or the network 
node on whose line 
printer or other output 
device your request is 
to be processed (CARDS, 
PAPER-TAPE, PLOT, and 
PRINT) . The node name 
must be of six or fewer 
characters and must be 
followed by two colons 
C :) • 
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MODIFY Command Switches (Cont.) 


/FEET : n BATCH 


ASCII 

COBOL 

/FILE: ELEVEN PRINT 

FORTRAN 


/FORMS: forms name 


/GENERIC 


/HEADER 


/JOBNAME : j obname 


specifies the decimal 
number of feet of 
spooled paper tape the 
job is allowed to punch 


specifies that the file 
consists of ASCII text, 
or COBOL SIXBIT text; 
or (ELEVEN) contains 
four eight-bit bytes in 
each 36-bit word; or is 
FORTRAN ASCII text, 
where column 1 of each 
line is interpreted as a 
carriage control 

character . 

Output specifies, in six or 
fewer characters, new 
forms (determining the 
size of banner, header, 
and trailer sections; 
the paper color, width, 
and weight; vertical 
format, carriage control 
tape, the number of 
plotter steps per inch, 
etc.) to use with the 
job 

Output allows the output to be 
produced on any 

available device (Use 
along with argument 
PRINT to cancel the 
/LOWERCASE or /UPPERCASE 
switch, or with PLOT, 
PRINT, CARDS, or 

PAPER-TAPE to cancel the 
/UNIT switch.) 

Output causes a header section 
containing the jobname 
to be plotted, printed, 
or punched before the 
file itself is produced 

All does not change the 
jobname, but specifies 
which job to modify. 
Same as jobname in 
"identifier" argument. 
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MODIFY Command Switches (Cont.) 


/LIMITrn Output places a new limit of n 

cards, feet, or pages on 
the output of the job 

/LOWERCASE PRINT specifies that the file 

is to be produced on a 
line printer capable of 
printing lowercase 

characters 


ASCII 

BCD 

/MODE: BINARY CARDS 

IMAGE 


ASCII 
BINARY 
/MODE: IMAGE 

IMAGE-BINARY 


ASCII 

/MODE: BINARY PLOT 

IMAGE 


ARROW 

ASCII 

/MODE: OCTAL PRINT 

SUPPRESS 


/NOHEADER 


designates the mode for 
punching the file onto 
cards. See the /MODE 
switch in the PUNCH 
command description for 
details . 


designates the mode for 
punching the file onto 
paper tape. See the 
/MODE switch in the 
PUNCH command 
description for details. 


designates the mode for 
plotting the file. See 
the /MODE switch in the 
PLOT command description 
for details. 


designates the mode for 
printing the file. See 
the /MODE switch in the 
PRINT command 

description for details. 

Output prevents a header 

section containing the 
jobname from being 
produced before the file 
is produced. 


PAPER-TAPE 
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MODIFY Command Switches (Cont.) 


/NOTE :message 


/PAGES :n BATCH 


Output labels the header 

section of output, i.e., 
the section displaying 
the jobname, with a 
message or notation of 
up to 12 characters. 
The message must be 
enclosed in double 
quotation marks if it 
contains spaces or 
punctuation characters. 

specifies the decimal 
number of spooled line 
printer pages the job is 
allowed to print 


/PRIORITY : n 


/PROCESSING-NODE : node name:: 

BATCH 


/REPORT: title 


PRINT 


NO 

/RESTARTABLE : YES BATCH 


All 


assigns a new 
reflecting the 
of the request, 
must be from 
with larger 
receiving 
treatment . 


number n 
urgency 
This n 
1 to 63, 
numbers 
earlier 


specifies the DECnet 
network node on whose 
CPU the job is to be 
run. The node name must 
be of six or fewer 
characters and must be 
followed by two colons 


scans your files and 
processes only those 
lines whose , first 
characters are the title 
you give. This title 
can contain up to 12 
characters (including 
the quotation marks that 
must enclose the title 
if it contains spaces) . 
The switch is used along 
with the COBOL report 
wr iter . 


specifies whether the 
job should be started 
again if the system 
crashes crashes and 
restarts . 
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MODIFY 

/SEQUENCE:n 


DOUBLE 
/SPACING: SINGLE 
TRIPLE 

/TIME : hh :mm : ss 


/TPLOT : n 


NO or 0 

/UNIQUE : YES or 1 


/UNIT:octal number 


/UPPERCASE 


/USER:user name 


Command Switches (Cont.) 


All does not change the 
sequence number of the 
job but rather specifies 
which job to modify. 
Giving this switch is an 
alternative to supplying 
a request ID as the 
request identifier when 
you have several jobs 
with the same jobname 
(if you supply only the 
jobname to identify the 
job, the MODIFY command 
affects all of them) . 


PRINT determines the spacing 

between printed lines 

BATCH revises the limit for 

the maximum amount of 
CPU time available to 
the job; given in 
hours, minutes, and 
seconds . 

BATCH limits to n the maximum 

number of minutes of 
spooled plotter time 
allowed for the job 


BATCH changes your 

declaration, if two or 
more jobs are to use the 
same connected 

directory, whether they 
must run at separate 
times 

Output directs your request to 
the line printer of the 
specified octal unit 
number 

PRINT specifies that the file 

is to be produced on a 
line printer that uses 
uppercase characters 

only 

PRINT, BATCH specifies the user whose 
request is to be 
modified; for 

privileged users only. 
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Characteristics 


MODIFY Effective Only Before Processing 

The MODIFY command affects a batch or output request only 
before processing has begun. After processing has begun, 
you can only cancel the request with the CANCEL command, and 
then make a new request. 


Hints 


Using the /DEPENDENCY-COUNT Switch 

You can use the /DEPENDENCY-COUNT switch to specify the 
order in which your batch jobs are processed. Set the 
dependency count of all but the first job to some positive 
value when you submit them, and include MODIFY commands in 
each job's control file to bring the next job's dependency 
count to 0 at the appropriate time. See Example 4. 


Special Cases 


/JOBNAME Switch 

In the singular case when you want to modify several queue 
requests of the same jobname using only one command, and 
that jobname is purely numerical (e.g., 5045), you must use 
the /JOBNAME : jobname switch as second argument to the MODIFY 
command. Do not also give the request ID or jobname as a 
command argument if you give the /JOBNAME : jobname switch. 


Effect on Memory and Terminal 


The MODIFY command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


CANCEL 

INFORMATION BATCH-REQUESTS 
INFORMATION OUTPUT-REQUESTS 

PLOT 


for removing batch and output 
requests 

for examining entries in the 
batch queue 

for examining entries in the 
output queues 

for placing requests in a plotter 
output queue 
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PRINT for placing requests in a line 

printer output queue 

PUNCH for placing requests in a card 

punch or paper tape punch output 
queue 

SUBMIT for placing requests in the batch 

input queue 


Examples 

1. Modify a batch request (of jobname ARTIFI) to make it start 
more quickly. 

B MODIFY BftTCH ARTIFI /PRIORITY :G3 
[1 Job Modified] 

@ 

2. Modify a print request (of jobname PHIAL) to include a note 
on the header page. 

e MODIFY PRINT PHIAL /NOTE: "DUE: 11/4" 

Cl Job Modified] 

e 

3. Modify one job of several having the same jobname. 

@ I NFORMAT I ON OUTPUT-REQUESTS /USER 
Printer Queue: 


Job Name 

Rea# 

Limit 

User 



PRTSK 

22S 

27 

LATTA 

/After: 8-No y -79 

17:00 

PRTSK 

23G 

27 

LATTA 

/After: 8-No y -79 

17:00 

PRTSK 

237 

27 

LATTA 

/After: 8-No y -79 

17:00 

PRTSK 

238 

27 

LATTA 

/After: 8-No y -79 

17:00 

TESTF1 

219 

5/1 

LATTA 

/Fo rms :NARR0W 



/After: 15-No y -79 17:00 

There are 5 Jobs in the Queue (None in Prodress) 


B MODIFY PRINT 237 / AFTER : 18 : 00 
Cl Job Modified] 

@ 
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4. Use the TYPE command to examine some of your control files. 
(Notice the use of the MODIFY command within these files to 
ensure that they are processed in a certain order when 
submitted together.) Submit these three control files and 
verify their placement in the batch input queue. 

S TYPE AROMZ , CTL 
ARUM1 . CTL . 2 

SRUN TESTF1 
SPRINT TESTF1 . RSM 

SMODIFY BATCH ARVM2 / DE PENDENCY - COUNT : 0 

ARUM2.CTL.2 

SRUN TESTF2 
SPRINT TESTF2.RSM 

SMODIFY BATCH ARVM3 /DEPENDENCY-COUNT : 0 

ARVM3 . CTL . 2 

SRUN TESTF3 
SPRINT TESTF3.RSM 
SPRINT SUM JOB * RSM 
S SUBMIT /AFTER: 17:00 AR0M1 

[Job A R V M 1 Queued* R e a u e s t - I D 2 4 0 > Limit 0:05:00] 

S SUBMIT / DEPENDENCY- COUNT : 1 ARP M2 

[Job A R 0 M 2 Queued* Reauest-ID 241 * Limit 0:05:00] 

S SUBMIT /DEPENDENCY-COUNT:! ARPM3 

[Job A R 0 M 3 Queued * Reauest-ID 2 4 2 » Limit 0:05:00] 

S I NFQRMAT I ON BATCH-REQUESTS /ALL/USER 

Batch Queue: 

Job Name Rea# RunTime User 


ARMM1 240 00:05:00 LATTA / Af t e r : 8-No u -79 1 7 : 00 

/ U n i a : Y e s /Restart:No /Assist:Yes /Sea:1804 
AR0M2 241 00:05:00 LATTA /Dep:l /Unia:Yes /Restart :No 

/Assist: Yes /Sea: 1805 

AR0M3 242 00:30:00 LATTA /Dep:l /Unia:Yes /Restart:No 

/Assist: Yes /Sea : 1 80G 
There are 3 Jobs in the Queue (None in Progress) 

S 
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Function 


The MOUNT command requests that the specified file structure or 
magnetic tape set be made available for your job's use. 


Format 


@ MOUNT medium (NAME) dev: /switch (es) 
where 

medium is one of the following: 


STRUCTURE - for mounting file 

structures (disk packs) 

TAPE - for mounting magnetic 
tapes 

dev: is either the structure identification 

(or alias), or the tape setname. It 
must be of six or fewer alphanumeric 
characters and must be terminated by a 
colon . 

/switches are keywords, chosen from the list 

below, indicating your choice of MOUNT 
command options 

Summary of MOUNT Command Switches (defaults in boldface) 


/CHECK-SETNAME 

200 

556 

800 

/DENSITY: 1600 
6250 

SYSTEM-DEFAULT 

7-TRACK 
/DRIVE-TAPE : 9-TRACK 

ANSI 

BYPASS 

/LABEL-TYPE : EBCDIC 
TOPS-20 
UNLABELED 

/NEW 

/NOUNLOAD 

/NOWAIT 

/OPERATOR 
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/PROTECTION : octal protection code Default code - 770000 

/READ-ONLY Default - unless /NEW or 

/SCRATCH specified 

/REMARK: 119-character remark 
/SCRATCH 

NUMBER number 

/STARTrVOLID volid Default number - 1 


/STRUCTURE -ID: structure identification 
/VOLIDS:list of volids 

/WRITE-ENABLED Default - if /NEW or /SCRATCH 

specified 


The switches /NOWAIT and /REMARK are useful with either the 
STRUCTURE or TAPE medium, while /STRUCTURE-ID is for STRUCTURE 
only; the other switches are for TAPE only. 


MOUNT Command Switches 


/CHECK-SETNAME 


200 

556 

800 

/DENSITY: 1600 
6250 

SYSTEM-DEFAULT 


7-TRACK 
/DRIVE-TYPE : 9-TRACK 


ANSI 

BYPASS 

/LABEL-TYPE : EBCDIC 
TOPS-20 
UNLABELED 


ensures that the setname of the 
mounted tapes matches the setname 
you specify as the "dev:" argument 
to the MOUNT command; otherwise an 
error will be generated. For 
labeled tapes only. 


specifies the density, in bits per 
inch, at which the tape set is to 
be read or written. Densities 200 
and 556 are for unlabeled tapes 
only. SYSTEM-DEFAULT, one of the 
values shown (usually 1600) , is 
established at system start-up 
time . 


specifies the type of drive on 
which the tape set is to be 
mounted. Labeled tapes must be 
mounted on 9-track drives. 


tells the system to read and write 
the tape set according to the 
specified label standard: ANSI; 
EBCDIC - IBM types (in read-only 
mode) ; TOPS-20 - a superset of 
ANSI used in TOPS-20 systems; 
UNLABELED - for unlabeled tapes 
only. BYPASS (for privileged users 
only) lets you read and write any 
tape, labeled or unlabeled, without 
any label processing. 
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MOUNT Command Switches (Cont.) 


/NEW 


/NOUNLOAD 


/NOWAIT 


/OPERATOR 


/PROTECTION : code 


tells the system that you are 
creating a new file set on an 
existing tape set, whose setname is 
then changed to be the name you 
specify as the dev: argument to 
the MOUNT command. (If the tape 
set has more than one volume, 
remember to specify their volids 
using the /VOLIDS or /OPERATOR 
switch.) The /CHECK-SETNAME and 
/READ-ONLY switches are ignored if 
present, and /WRITE-ENABLED is 
assumed. Do not give the /START 
switch if you give /NEW. 

asks the system not to unload a 
volume (reel) of tape from its tape 
drive when the drive is released by 
a volume switch (change of volumes 
required by a read or write 
operation) or DISMOUNT command. 
Use this switch to facilitate 
processing when sufficient drives 
are available. 

tells the system to return your 
terminal to TOPS-20 command level 
as soon as you give the MOUNT 
command, and to send a message to 
your terminal when the request has 
been processed. Otherwise, your 
terminal waits for the message. 

asks the operator to specify to the 
system the volids of the tape set 
you wish to mount. Do not use if 
you have given the /VOLIDS switch. 

specifies a 6-digit octal 
protection code for new volumes of 
tape written during the current 
mount request. The owner always 
has full access to his tapes, so 
the first two digits are always 
interpreted as "77"; also, user 
groups and directory groups have no 
effect on tape access, so the 
middle two digits are always 
interpreted as "00". Therefore, 
although six digits can be 
specified, only the last two digits 
affect the tape's protection code. 
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/READ-ONLY 


/REMARK: "remark" 


/SCRATCH 


MOUNT Command Switches (Cont.) 


(If you specify only two digits, 
these will be used as the last two 
digits of the protection code.) 
These two digits should be the sum 
of the values corresponding to the 
modes of access you want to allow, 
chosen from the following list: 

40 - read files in the file set 

10 - overwrite or modify files 
in the file set 

04 - append files to the end of 
the file set 

For tapes of label-type TOPS-20 
only. 

Default code - 770000 

ensures that all volumes in the 
tape set will be mounted without 
write rings, to prevent accidental 
erasures 

Default except when /NEW or 
/SCRATCH is specified 

sends the specified remark (of 119 
or fewer characters, which must be 
enclosed in quotation marks (" )) 

to the operator when he is notified 
of your mount request. For 
structures, the remark will be sent 
only if the structure must be put 
on line or physically mounted to 
satisfy your mount request. 

same as /NEW, except that the 
volumes in the file set you create 
will be drawn from the , pool of 
scratch tapes (tapes not presently 
owned by a particular user) , rather 
than from volumes you specify. Use 
this switch to create a new file 
set when you are not supplying the 
volumes of tape to be used. 
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MOUNT Command Switches (Cont.) 


NUMBER number 
/START : VOL ID volid 


/STRUCTURE-ID: structure 

identification 


/VOLIDS : volid , volid,... 


/WRITE-ENABLED 


tells the system which volume 
(reel) of tape to mount first when 
satisfying your request. (You must 
also give the /VOLIDS switch, 
specifying the group of volumes you 
will be using.) Use the NUMBER 
argument to give the order of this 
volume within the group (e.g., 1 
for first, 2 for second), or give 
the VOLID argument to repeat the 
volid explicitly. You can use this 
switch to save time and expense 
when you know which volume you will 
be using first. 

Default - NUMBER 1 


gives the name of the structure as 
recorded in the disk(s); used when 
you gave an alias different from 
the structure identification as 
argument "dev:", above. See 
Hints - Using the /STRUCTURE-ID 
Switch, below. For privileged 
users only. 

specifies the volids (volume 
identifiers) of the volumes (reels) 
of tape you want to access. These 
must be consecutive volumes, 
usually of the tape set specified 
as the "dev:" argument to the MOUNT 
command. Although you need not 
specify every volume in the set, 
any volume not specified will not 
be accessible. Do not use this 
switch if you have given the 
/OPERATOR switch. See also 
Characteristics - Using the /VOLIDS 
Switch, below. 

ensures that all volumes in the 
tape set will be mounted with write 
rings 

Default when /NEW or /SCRATCH 
is specified 
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Characteristics 


Action of MOUNT STRUCTURE Command 

If the Structure Has Already Been Mounted 

If the structure for which you give the MOUNT command 
is currently mounted, the system simply increases by 1 
the mount count, i.e., the number of users who have 
given the MOUNT but not the DISMOUNT command for the 
structure, and returns your terminal to TOPS-20 command 
level. A structure is not ordinarily dismounted until 
its mount count is 0. 

If the Structure Has Not Yet Been Mounted 

If the structure for which you give the MOUNT command 
is not currently mounted, your reguest stays in the 
mount request queue until it is acted upon by the 
operator or until you cancel the request. 

Setnames (File Set Identifiers) 

The setname, or file set identifier of a set of tapes, is 
part of the label information written into each volume of 
the set. It is rewritten every time the /NEW or /SCRATCH 
switch is included in a MOUNT command. The "dev:" argument 
of the MOUNT command becomes the setname in this case. If 
you add volumes to an existing tape set, the system uses the 
setname of the old volumes as the setname of the new ones. 

Using the /CHECK-SETNAME Switch 

If you give the MOUNT command to use an existing file 
set (i.e., you do not specify the /NEW or /SCRATCH 
switch) , you can give the /CHECK-SETNAME switch to be 
sure that the setname written on the tapes matches the 
setname you specify as the "dev:" argument to the MOUNT 
command. However, because more than one set of tapes 
can have the same setname, the /CHECK-SETNAME switch 
does not ensure that the correct tape set will be 
mounted. For information about ensuring that the 
correct tapes are mounted, see Characteristics - Using 
the /VOLIDS Switch, below. 

Volids (Volume Identifiers) 

The volid, or volume identifier of a volume (reel) of 
labeled tape, is part of the label information written into 
each volume of tape. It is written only once, by the 
operator during the tape's initialization procedure, and is 
not changed during the life of the tape. (You should also 
affix a paper label displaying the volid onto each reel of 
tape.) You can get a list of volids for previously specified 
or newly written volumes in any mounted tape set by giving 
the INFORMATION VOLUMES command for that set. 
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Using the /VOLIDS Switch 

If you give the MOUNT command to use an existing 
multi-volume tape set (i.e., you do not specify the 
/SCRATCH switch) , you can give the volid of each volume 
you want to use as an argument to the /VOLIDS switch. 
The system ensures that the correct volumes of a 
labeled tape will be mounted for your job as long as 
you use the /VOLIDS switch to specify them. (If the 
tape set does not consist of labeled tapes, the system 
does not ensure that the correct tapes are mounted.) 
The volids must represent consecutive volumes and must 
be specified in the order written (oldest first) . Note 
that in general you cannot rely on any apparent 
alphanumerical order when specifying the volids but 
must maintain your own list of the volids in each tape 
set. (See Hints - Keeping Track of Volids, below.) You 
need not specify every volid in the tape set, but any 
volume not specified will not be accessible through the 
current MOUNT command. See also Characteristics - 
Using the /OPERATOR Switch, and Special Cases - 
Single-volume Tape Sets, below. 

Using the /OPERATOR Switch 

You can use the /OPERATOR switch instead of the /VOLIDS 
switch when asking the system to mount a multi-volume 
set of tapes. The /OPERATOR switch sends a message to 
the operator asking him to specify the volid of each 
volume himself. You must be sure to supply the 
operator with a list of the volids you want him to 
specify before giving a MOUNT command that contains the 
/OPERATOR switch. 


Hints 


Checking Whether Operator is Present 

You can give the INFORMATION SYSTEM-STATUS command to find 
out whether the operator is in attendance and can process 
your mount request. Even if the operator is not in 
attendance, your request remains valid until he returns and 
deals with it in some way. 

Using the /STRUCTURE-ID Switch 

The /STRUCTURE-ID switch (available only to users with 
enabled Wheel or Operator capabilities) gives the name of 
the structure as recorded in the disk(s) of the structure 
itself, where it is used by the system for identification. 
Be sure that the structure identification is also written 
with a felt-tip marker on the upper surface of each disk 
pack, and on a gummed label on the pack cover. Unless you 
give this switch, the system mounts the structure with its 
structure identification as alias. (The alias is the name 
you use when specifying the structure in file specifications 
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and commands; the INFORMATION STRUCTURE and INFORMATION 
AVAILABLE DEVICES commands list structures by alias only.) 
The /STRUCTURE-ID switch allows an enabled Wheel or Operator 
to mount a structure under a name different from the one 
recorded in the structure. Use this switch for mounting a 
structure whose structure identification is the same as the 
alias of a currently mounted structure. In such cases give 
the MOUNT STRUCTURE command with any unique alias as the 
"dev:" argument, and specify the structure identification 
with the /STRUCTURE- ID switch. In subsequent file 
specifications and commands referring to the structure, use 
the alias only. 

Dummy "dev:" Arguments for Mounting Tapes 

If you want to use different tape sets on successive 
runnings of a single program, you can refer to those tape 
sets as a logical name in the program, and use this logical 
name as the "dev:" argument of your MOUNT command when 
mounting tapes. As long as you also specify the volid of 
each volume of tape with the /VOLIDS switch (or use the 
/OPERATOR switch to ask the operator to do so) , you need not 
give the actual setname of the tape set as the "dev:" 
argument to the MOUNT command. The system considers the 
"dev:" argument you supply to be a logical name defined as 
the mounted tape set. Therefore, your program can access 
the tape set using this logical name. 

Keeping Track of Volids 

Unless your site has a tape cataloging facility, you must 
keep your own record of the volids in each of your tape 
sets. After creating a file set on a new tape set, i.e, one 
not previously owned by you (by giving the MOUNT command and 
including the /SCRATCH switch) , you should give the 
INFORMATION VOLUMES command for the set before giving the 
DISMOUNT command. The system will respond by printing a 
list at your terminal of the volids of all volumes in the 
tape set. Similarly, if you mount an old tape set and then 
perform write operations, you should give INFORMATION 
VOLUMES before giving DISMOUNT to learn the volids of any 
volumes added to the set. Keep an ordered list of these 
volids in a disk file in your directory, for use in 
subsequent MOUNT commands when you give the /VOLIDS switch. 


Special Cases 


Single-volume Tape Sets 

If the tape set you want to mount consists of a single 
volume of tape, you need not give the /VOLIDS or /OPERATOR 
switch to specify its volid. You can give the volid as the 
"dev:" argument to the MOUNT command. 
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Structures Unavailable for Mounting 

If the operator has given the OPR program command, SET 
STRUCTURE UNAVAILABLE for a specified structure, the system 
sends an error message including the phrase, "Structure 
unavailable for mounting" in response to subsequent MOUNT 
commands for the structure. 


Restr ictions 


Using SET TAPE Commands 

The TOPS-20 SET TAPE DENSITY and SET TAPE PARITY commands 
are applicable to unlabeled tapes only (but see also 
Warnings - /DENSITY Switch Has Limited Effect for Unlabeled 
Tapes, below). The SET TAPE FORMAT and SET TAPE 
RECORD-LENGTH commands are applicable to both labeled and 
unlabeled tapes, but to labeled tapes only if they are 
mounted using the /LABEL-TYPE : ANSI or /LABEL-TYPE : TOPS-20 
switch. In addition, the files that you read from or write 
to such a labeled tape must be in 36-bit format, and they 
must not have the ; FORMAT attribute as part of their 
specification . 


Warnings 


POP Command Cancels Unsatisfied Mount Requests 

If you have given a PUSH command to obtain a new level of 
TOPS-20 and then give a MOUNT command within that new level, 
a subsequent POP command will cancel your mount request. 
However, if the specified structure or tape set has already 
been mounted, it will remain mounted despite your POP 
command . 

/DENSITY Switch Has Limited Effect for Unlabeled Tapes 

The /DENSITY switch, when given in a MOUNT command for an 
unlabeled tape, ensures only that your tape set will be 
mounted on a drive that supports the specified density. It 
does not ensure that the tape set will be read or written at 
this density. To specify the density at which unlabeled 
tapes are to be read and written, give the SET TAPE DENSITY 
command . 


Effect on Memory and Terminal 


The MOUNT command does not affect memory, and, if you have 
included the /NOWAIT switch, leaves your terminal at TOPS-20 
command level. If you have not given the /NOWAIT switch, your 
terminal waits until the system has processed your request, or 
until you give a CTRL/C to return to TOPS-20 command level. This 
CTRL/C does not cancel your request. 
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Related Commands 


for withdrawing mount requests 
before they are processed. 

for giving up access to a 
particular tape drive or disk 
drive 

INFORMATION AVAILABLE DEVICES for finding out just the names 

of structures available for 
mounting (these are listed 
after DSK and PS, and before 
the line printers (LPT, LPTO, 
etc . ) ) 

INFORMATION MOUNT-REQUESTS for finding out information 

about pending mount requests 
for structures and tape sets, 
and about currently mounted 
tape sets 

INFORMATION STRUCTURE for finding out information 

about currently mounted 

structures 

INFORMATION VOLUMES for finding out the volids of 

all mounted volumes (including 
newly created volumes) of a 
tape set 

SET TAPE commands for establishing job-wide 

defaults for tape density, 
format, parity, and record 
length . 


Examples 


1. Mount a structure (it is already physically mounted). 

B MOUNT STRUCTURE SNflRK : 

Structure S N A R K : mounted 
@ 

2. Mount a structure that is not yet physically mounted. After 
completing the command, give CTRL/Cs to return to TOPS-20 
command level. 

B MOUNT STRUCTURE PYBL ; 

[Mount Request PYBL Queued > R e q u e s t - I D 205] 

[MOUNT request remaining in queue] 
j_C 
@ 


CANCEL 

DISMOUNT 
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3. Mount a structure, then give CTRL/Cs to return to TOPS-20 
command level and cancel the mount request. 

B MOUNT STRUCTURE PYBL: 

[Mount Request PYBL Queued t Request-ID 13B3 
[MOUNT request remaining in queue] 

"C 

i 

[1 mount request canceled] 

B 

4. Find out what structures are available for mounting (these 
are listed after DSK and PS and before the line printers) , 
and mount one of these. 

B I NFQRM AT I ON AVAILABLE DEVICES 
Devices a nailable to this Job: 

DSK t PS » LANG » TYM » MISC » SNARK » REL4 » LPT t LPTO 
LPT 1 » CDR t CDP . PCDPO » FEO t FE4-15 » PTY7-10 
PTY23-B 1 » NUL » PLT t PLTO » DON , SRU 
Devices assigned to/opened by this Job: T T Y 2 2 0 
B MOUNT STRUCTURE REL4 : / NON A I T 
Structure R E L 4 : mourite d 
B 

5. Find out whether the structure you want to use has already 
been mounted (it has not), then mount it yourself. Note that 
you must first enable Wheel or Operator capabilities to mount 
this pack, because its structure identification is PS: and 
you must therefore mount it under a different alias. 

Once the structure is mounted, access a directory on the 
structure to obtain group rights, then find out what 
directories and files are on the structure. 

@ I NFDRMAT I ON AVAILABLE DEVICES 
Devices available to this Job: 

DSK , PS , LANG , UETP , NETWRK » MISC t SNARK t REL4 , PACK AG > LPT 
LPTO » LPT 1 i CDR » CDP . PCDPO , FEO-15 » PTY13-B1 » NUL » PLT 
PLTO . DCN . SRM 

Devices assigned to/opened by this Job: T T Y 2 2 0 
BENABLE 

$ MQUNT STRUCTURE LATB ; /STRUCTURE- I D : PS : /REMARK :" MOUNT PACK - 
ON FIRST APAILABLE RPOB DR I PE " /NONA I T 
[Mount Request LATB Queued i Request-ID 157 J 
$ D I SABLE 

BINFQRMATION MOUNT-REQUESTS 


T a p e / D i s k Mount Queue: 


U o 1 u m e 

Status 

Type 

Write 

R e q Name 

R e q # 

Job# 

User 

MARK 

MT A 1 

Tape 

Enabled 

MARK 

12B 

BO 

HOOSEPIAN 

TAPE 

MT A3 

Tape 

Enable d 

TAPE 

148 

13 

WALLACE 

LATB 

W a i t i n 3 

Disk 


LATB 

157 

G5 

LATTA 


There are 3 Requests in the Queue 
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Structure L A T B : mounte d 
@ I NFQRMAT I ON STRUCTURE LATB: 

Status of structure LATB: 

Mount count: 1 » open file cou n t : 0 » u nits in structure: 1 
Foreign 

Users who haue MOUNTed LATB: LATTA 
No users are ACCESSind LATB: 

No users CONNECTed to LATB: 

@ 

@ 

@ 

B ACCESS LATB : (OPERATOR?- 
P a s s w o r d : 

@ I NFQRMAT I ON DIRECTOR V LATB: <*> , 

@@NAME-DNLY 


BS 

Name 

LATB : 

< ROOT-DIRECTORY 

Name 

LATB : 

< accounts > 

Name 

LATB: 

<NEW-SUBSYS> 

Name 

LATB : 

<NEW-SYSTEM> 

Name 

LATB : 

<OPERATOR> 

Name 

LATB: 

< REMARKS > 

Name 

LATB: 

< S P 0 0 L > 

Name 

LATB : 

<SUBSYS> 

Name 

LATB: 

< SYSTEM > 

Name 

LATB: 

< U E T P > 

Name 

LATB : 

< UETP . L I B > 

Name 

LATB : 

<UETP.RUN> 

@ DIRECTORY 

LATB : < SYSTEM > 


LATB :< SYSTEM) 
4-C0NFIG.CMD.2 
. QMD . 1 

4-SETSPD.EXE. 1 
BUGSTRINGS.TXT. 1 
CHECKD.EXE. 1 
. HLP . 1 
DUMP.EXE. 1 
ERRMES.BIN. 1 
ERROR. SYS. 1 
EXEC.EXE, 1 
LPFORM . INI . 1 
MAKDMP . EXE . 1 
MONBCH.EXE. 1 
MONBIG.EXE. 1 
MON I TR . EXE . 1 
MON MD . . . 

@ 


6. Mount a one-volume magnetic tape, labeled or unlabeled. 
B MQUNT TAPE DAY : 

[Mount Request DAY Queued » Request-ID S3] 

[Tape set DAY. volume DAY mou n ted] 

[DAY: defined as MT3 : ] 

@ 
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7. Ask that a new tape set be created for you from scratch 
tapes, and copy some files to it. Before dismounting the 
tape set, find out the volids of the tape volumes you were 
assigned . 

6 MQUNT TAPE LAT: / SCR AT CH / L AB E L - T Y P E : T 0 P 5 - 20 
[Mount Request L A T Queued » R e q u e s t - I D 104 
[Tape set LAT t volume LAT mounted] 

[ LAT : defined as MT3 : ] 

B COPY DN20A-11*. SYS LAT : 

DN2QA-1 1A.SYS. 1 => MT3 : DN20A- 1 1 A . SYS . 131071 [OK] 

DN20A- 1 1 B . SYS . 1 => MT3 : DN20A- 1 1 B . SYS . 131071 [OK] 

DN20A- 110. SYS . 1 => MT3 : DN20A- 1 1 C , SYS . 131071 [OK] 
e iNFORMATION VOLUMES LAT: 

Volumes of tape set LAT: 0 1 P 0 2 » 0 0 L 1 6 
e DISMOUNT TAPE LAT : 

[Tape dismounted » logical name LAT : deleted] 

S 

8. Find out if any tape drives can be used without giving the 
MOUNT command (any such drives will be of the form MTAn) . 
Assign one of these and use the PLEASE program to ask the 
operator to mount your (unlabeled) tape on this drive. Set 
the necessary tape parameters, position the tape, and copy a 
file from tape to the line printer. Then give up the 
resources you have been using. 

(^ INFORMATION AVAILABLE DEVICES 
Devices available to this Job: 

DSK » PS , LANG , TYM , MISC » SNARK , REL4 » MTA5 » LPT , LPT0 , LPT 1 
CDR » GDP , PCDP0 * FEO , FE4-15 , PTY23-G1 » NUL > PLT 
PLTO . DCN » SRV 

Devices assigned to/opened by this Job: T T Y 2 2 0 
B ASS I GN MTA5: 

B PLEA5E 

PLEASE > MESSAGE 

Enter Text and Terminate with "2 

PLEASE MOUNT MY TAPE NAMED UNLBLD IN READ-ONLY MODE ON MTA5: > 
U1HICH I HAVE ASSIGNED TD MY JOB. MTA5 : IS A 7-TRACK DRIVE 
THAT SUPPORTS TAPE DENSITIES OF BOO BPI > CORRECT? 

* Z [Operator Notified at 16:35:20] 

PLEASE > EX IT 
B SET TAPE DENSITY 800 
B SET TAPE RECORD-LENGTH 12S 
B REN I ND MTA5 : 

B SKIP MTA5 : 4 FILES 
B COPY MTA5 : LPT : 

MTA5 : = > LPT : [OK ] 

B UNLOAD MTA5 : 

B DEAS5IGN MTA5: 

B 
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9. Perform the same task using the same volume of tape as in the 
previous example by using the MOUNT command. Note that you 
still cannot specify a particular tape file by name when the 
tape is an unlabeled tape. 

B MQUNT TftPE UNLBLD : / LABEL - TY PE ; UNLftBELED/ DENS I TY ; BOO / DR- 
IVE-TYPE : 7 - TRACK 

[Mount Request UNLBLD Queued * R e q u e s t - I D 1 Z 8 ] 

[Tape set UNLBLD * volume UNLBLD mounted ] 

[UNLBLD: defined as MT3:] 

B INFORMATION MOUNT- REQUESTS/USER 

T a p e / D i s K Mount Queue: 

Volume Status T'/pe Write Req Name R e q # Job# User 


UNLBLD MTA4 Tape Locked UNLBLD 128 55 LATTA 

There is 1 Request in the Queue 
B REW I ND UNLBLD : 

B SK I P UNLBLD: 4 FILES 
B COPY UNLBLD: LPT: 

MT3 : . . a => LPT: [OK] 

B DISMDUNT TAPE UNLBLD: 

[Tape dismounted* 1 o 3 i c a 1 name UNLBLD : deleted] 

B 

10. Mount a labeled tape containing the same files as in the 
previous two examples, and perform the same task. Note that 
you need not specify tape parameters in this MOUNT command, 
as this information is present in the tape labels and is read 
automatically. Also, the system ensures that the correct 
volume of tape is used. Finally, you can specify the tape 
file by name when using labeled tapes. 

B MQUNT TAPE LBLD : /LABEL-TYPE : ANS I / VOL I PS : 00 1 1 5 
[Mount Request LBLD Queued * Request-ID 133] 

[Tape set LBLD* volume 00115 mounted] 

[LBLD: defined as MT3 : ] 

B INFQRMATION MOUNT - REQUESTS / USE R 

T a p e / D i s K Mount Queue: 

Volume Status Type Write Req Name Req# Job# User 


00115 M T A 0 Tape Locked LBLD 133 55 LATTA 

There is 1 Request in the Queue 
B REW I ND LBLD : 

B COPY LBLD : CDMPR ♦ BRN LPT: 

MT3 : C0MPR . BRN . 13107 => LPT:C0MPR [OK] 

B DISMOUNT TAPE LBLD ; 

[Tape dismounted* 1 o 3 i c a 1 name LBLD : deleted] 

B 
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11. Mount a two-volume tape set (using the NOUNLOAD, switch to 
simplify volume changes) and overwrite any existing files 
with new files. Then rewind the tape set. Give various 
INFORMATION commands as you proceed, to verify logical name 
and device assignments and to determine whether new volumes 
have been written. 

B MOUNT TAPE LAT: /WRITE-ENABLED/NOUNLQAD/NOWAIT/VOL- 
I D 5 : D B L 0 1 , DBL02 

[Mount Request LAT Queued , Request-ID 19] 

[Tape set LAT » volume D B L O 1 mounted] 

[LAT: defined as M T 0 : ] 
e iNFQRMATION MOUNT-REQUESTS /USER 

Tape/DisK Mount Queue: 

Volume Status Type Write R e q N a m e Req# Job# User 

DBL01 MTA1 Tape Enabled LAT 19 7 LATTA 

There is 1 Request in the Queue 

@ I NFDRMAT I UN AVAILABLE DEVICES 
Devices available to this Job: 

DSK , PS, LANG, SNARK, NTWORK , REL4 , MISC, PACK AG, MTA5 
MTO , LPT , LPT 0 , LPT1 , CDP , PCDPO , FEO , FE2-15 , PTY13-S1 
NUL , PLT , PLTO , DCN , SRV 

Devices assigned to/ opened by this Job: M T 0 , T T Y 2 1 7 
e iNFQRMATION LOG I CAL - NAMES JOB 
LAT : = > MTO : 

SYS: => DSK: ,SYS: 

B REWIND LAT: / ENT I RE - VOLUME - SET 
0 CQPY HL P : * , HL P LAT: 

P S : < H E L P > A C C T 2 0 . H L P . 1 => MTO : ACCT20 . HLP . 131071 [OK] 
PS:<HELP>ACCTPR.HLP. 1 = > MTO : ACCTPR . HLP . 1 3 1 07 1 [OK] 

P S : < H E L P > W A I T . H L P , 2 => MT0:WAIT .HLP. 131071 [OK] 

PS:<HELP> WATCH, HLP. B => MTO : WATCH . HLP . 131071 [OK] 
e iNFQRMATION MOUNT - REQUESTS /USER 

Tape/DisK Mount Queue: 

Volume Status Type Write Req Name R e q # Job# User 

DBL02 MTA3 Tape Enabled LAT 19 7 LATTA 

There is 1 Request in the Queue 

e iNFQRMATION VOLUMES LAT : 

Volumes of tape set LAT: D B L 0 1 , D B L 0 2 
B REWIND LAT; / ENT I RE - V OLU ME - S ET 
e iNFQRMATION MO U N T - REQUES T 5 /USER 

T a p e / D i s k Mount Queue: 

Volume Status Type Write Req Name Req# Job# User 


DBL01 MT A 1 Tape Enabled LAT 19 7 LATTA 

There is 1 Request in the Queue 

e 
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12. (For privileged users only.) Enable your capabilities and 
call the OPR program, then give the PUSH command to OPR. 
(This action puts you at TOPS-20 command level, but allows 
you also to see the OPR messages caused by your TOPS-20 
commands.) Repeat the write operations of the previous 
example, then dismount the tape set and exit from the OPR 
program. Notice that, because of the /NOUNLOAD switch in 
your original MOUNT command, both volumes of your tape set 
remain mounted on their drives. Therefore, you can mount the 
tapes again without operator assistance. 

B ENABLE 
$ 0 PR 

0 PR > PUSH 


TOPS-20 Command processor 4(553) 

B REWINDLAT; /ENTIRE-VOLUME-SET 
B COPY HLP : * , * LAT : 

P S : < H E L P > A C C T 2 0 . H L P . 1 = > MTO : ACCT20 , HLP , 1 3 1 07 1 [OK] 
PS:<HELP>ACCTPR.HLP. 1 = > MTO : ACCTPR . HLP . 1 3 1 07 1 [OK] 


P S : < H E L P > C H K P N T .HLP. 1 => MTO : CHK PNT . HLP . 131071 
15:11:55 --Tape Drive Released By User-- 

M T A 1 : Volume D B L 0 1 R e m a i n i n s m o u n ted on d r i u e 

15:11:57 — MTA3: Given To Request 19 — 

V o 1 u m e D B L 0 2 n o w i n u s e b y 
User LATTAt Job 7 » Terminal 217 

[OK] 

P S : < H E L P > C 0 B D 0 T . HLP , G => MTO : COBDDT . HLP . 131071 [OK] 


PS: < HELP > WAIT , HLP , 2 => MTO : WA I T , HL P . 131071 [OK] 

PS :< HELP > WATCH. HLP. G = > MTO : WATCH . HL P , 1 3 1 07 1 [ OK ] 

B INFQRMATIQN VOLUMES LAT: 

Volumes of tape set LAT: DBL01 »DBL02 
B INFQRMATIQN MOUNT-REQUESTS /USER 

T a p e / D i s k Mount Queue: 

Volume Status Type Write Res Name Res# Job# User 

DBL02 MTA3 Tape Enabled LAT 19 7 LATTA 

There is 1 Resuest in the Queue 

B REWINDLAT: / ENT I RE - VOLUME - SET 

15:14:51 --Tape Drive Released By User-- 

M T A 3 : Volume D B L 0 2 R e m a i n i n S m o u n ted on d r i y e 

15:14:51 — M T A 1 : Given To Resuest 19-- 

V olume D B L 0 1 n o w i n u s e b y 
Use r LATTA » Job 7 , Terminal 217 
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^ DISMOUNT TAPE LAT : 

[Tape dismounted t 1 □ 3 i c a 1 name L A T : deleted] 

15:15:21 --Tape Drive Released By User-- 

MTAl: Volume DBLOl Remainini mounted on drive 

@ PD P 

DPR > E K I T 
$ D I 5 ABLE 
@ 

13. Mount the same tape set as in the previous examples, but ask 
the operator to specify the volids. Use the PLEASE program 
to help you. 

B MOUNT TAPE LAT: / WR I TE - ENABLED / NOUNLOAD / NO W A I T / 0 PER ATOR 

[Mount Request LAT Queued t Request-ID 1971 

B PLEASE 

PLEASE)- MESSAGE 

Enter Text and Terminate with " Z 
PLEASE ENTER THE VDLIDS DF MY TAPE SET LAT: FOR 
REQUEST 197. THEY ARE RECORDED IN YOUR TAPE 
LIBRARY CATALOG. THANKS. 

'• Z [Operator Notified at 12:59:52] 

PLEASE > EX IT 

@ I NFQRMAT I ON MOUNT-REQUESTS /USER 
Tape/DisK Mount Queue: 

Volume Status Type Write Res Name Res# Job# User 


DBLOl Waiting Tape Enabled LAT 197 65 LATTA 

There is 1 Request in the Queue 

e 
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Function 


The PLOT command places requests in a plotter output queue. 


Format 


@PLOT (FILES) /switch(es) f ilespec/switch (es) , . . . 
where 

switches are keywords, chosen from the list below, 

indicating your choice of PLOT command options. 
These switches are of two kinds: job switches and 
file switches. 

Job switches apply to all files specified in the 
command, no matter where you give the switches. 

File switches have different effects depending on 
their positions in the command line: placed 

before all files in the command, they act as 

defaults for all; otherwise they affect only the 
nearest preceding file. 

Defaults are shown in the list of switches 

filespec is the specification of a file you wish to plot. 

You can use wildcard characters (% and *) to 
specify more than one file. 

,••• means that, after a comma, you can give more 

arguments of the form already shown 

Summary of PLOT Command Switches (defaults in boldface) 


Job Switches 

(affecting the entire command) 


/ACCOUNT : accounnt Default account - your current 

account 

/AFTER:date and/or time 
/DESTINATION-NODE: node name 

/FORMS: forms name Default forms name - NORMAL 

/GENERIC 

/JOBNAME : 6-char acter name Default name - first six 

characters of first 
filename in request 


/LIMIT : n 

/NOTE : 12-char acter message 
YES 

/NOTIFY : NO 
/PRIORITY: n 
/SEQUENCE : n 
/UNIT:octal number 
/USER:user name 


Default n - calculated from length 
of files 


Default n - 10 
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File Switches 

(affecting only the nearest preceding file, 
unless placed before all filespecs) 

/COPIES : n Default n - 1 

/DELETE Default for files of type . LST 

/HEADER 

ASCII 

/MODE: BINARY 
IMAGE 
/NOHEADER 

/PRESERVE Default for all files except those 

of type .LST 


PLOT Command Switches 


Job Switches 

(affecting the entire command) 

/ACCOUNT: account specifies the account of 39 or 

fewer characters to charge for your 
plotting request. This account 
must be valid for your user name. 

Default account - your current 

account . 
Check with 
INFORMATION 
JOB-STATUS. 

/AFTER: date and/or time, or ensures that the job will not be 

plotted until after the date 
day of week (or TODAY) and/or time specified. NOV-12-79 
and/or time and 18:00 illustrate two arguments 

to this switch. If you give both 
date and time, separate them with a 
space. When given alone, the time 
may be preceded by a plus sign (+) , 
which will delay processing by the 
indicated length of time from the 
present . 

Alternatively, you can give a day 
of the week (e.g., MONDAY) or TODAY 
as argument; then the job will not 
be plotted until the beginning of 
the following day. If you follow 
this argument with a plus sign and 
a time, the job will be further 
delayed by this amount. 
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/DESTINATION 


/FORMS : forms 


/GENERIC 


/ JOBNAME : name 


/LIMIT: n 


/NOTE rmessage 


PLOT Command Switches (Cont.) 


•NODE : node name:: specifies the DECnet network node 
on whose plotter your request is to 
be satisfied. The node name must 
be of six or fewer characters and 
must be followed by two colons 

name specifies, in six or fewer 

characters, the forms (determining 
the size of banner, header, and 
trailer sections; the paper color, 
width, and weight; the number of 
plotter steps per inch, location of 
the origin for plotted data, etc.) 
to use for the plotting job. Using 
this switch may delay processing 
until the operator can mount the 
proper forms. Note that your 
installation may provide a 
different default argument to this 
switch . 

Default forms name - NORMAL 

allows any plotter to be used for 
filling the request; use this 
switch to override a previous /UNIT 
switch . 

Default 


assigns a name (of six or fewer 
characters) to the plotting job 

Default name - first six 

characters of 
first filename 
in the request 


places a limit of n minutes of 
plotter time on the output of the 
plotting job 

Default limits, usually 

adequate, are computed 
from the size of the 
files you want plotted 


labels the header section of 
output, i.e., the section 
displaying the jobname, with a 
message or notation of up to 12 
characters. The message must be 
enclosed in double quotation marks 
if it contains spaces or 
non-alphanumer ic characters. 
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PLOT Command Switches (Cont.) 


YES 

/NOTIFY: NO 


/PRIORITY :n 


/SEQUENCE :n 


/UNIT:octal number 


tells the system whether to send a 
message to your terminal when the 
request has been satisfied 
Default argument - NO 
Default argument (if switch is 
given) - YES 

assigns a number n, reflecting the 
urgency of the plot request. This 
n must be from 1 to 63, with larger 
numbers receiving earlier 

treatment. Note that for 

non-pr ivileged users the maximum 
priority that can be specified is 
lower (usually 20) , and that your 
installation may provide a 
different value both for this 
maximum and for the default 
pr ior ity . 

Default n - 10 

specifies sequence number n for the 
printing request, which you can use 
when modifying or canceling the 
request 

directs your request to the plotter 
of the specified octal unit number 


/USERruser name specifies the user who is to be the 

owner of the plot request. For 
privileged users only. 


File Switches 

(affecting only the nearest preceding file, 
unless placed before all file specifications) 


/BEGIN : n 


/COPIES : n 


/DELETE 

/HEADER 


starts the plotting at page n of 
the file 

Default n - 0 

requests that n copies of the file 
be plotted; n must be less than or 
equal to 62. 

Default n - 1 

deletes the file after plotting 

Default for files of type .LST 

causes a header section containing 
the jobname to be produced before 
the file itself is plotted 

Default 
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PLOT Command Switches (Cont.) 


ASCII 

/MODE : BINARY 
IMAGE 


/NOHEADER 

/PRESERVE 


designates the mode for plotting 
the file. ASCII treats each word 
of a disk file as five seven-bit 
bytes, and truncates each byte to 
six bits before plotting it. 
BINARY treats each word as six 
six-bit bytes, each of which is 
plotted without modification. 
IMAGE is the same as BINARY. 

prevents the production of a header 
section before the file 

saves the file after plotting 

Default for all files except 
those of type . LST 


Output 


Jobname , Request ID, Limit, Number of Input Files 

As soon as you complete a valid PLOT command, the system 
responds by printing, on your terminal, the jobname, request 
ID number, the limit in minutes of plotter time assigned to 
the request, and the number of input files in the request. 


Characteristics 


Ordinary Operation - No Switches 

For most purposes you can use the PLOT command with just a 
series of filespecs for arguments. 

Switch Defaults Set by System Manager 

The defaults shown in the list of switches are correct for 
most user sites. However, your system manager can change 
some of those default settings. The switches most commonly 
affected are: /FORMS, /HEADER and /NOHEADER, /LIMIT, and 

/PRIORITY. 
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Hints 


Using SET DEFAULT PLOT 

If there are switches that you always or usually supply when 
using PLOT, give the SET DEFAULT PLOT command to establish 
them as defaults (at the current TOPS-20 command level) for 
the remainder of your terminal session. The switches will 
then behave as if you had typed them directly after the 
command name. You can supersede any of these default 
switches by actually supplying the switch, with another 
value, when you give the PLOT command. Put SET DEFAULT PLOT 
into a file of specification COMAND.CMD in your log-in 
directory if you want these default switches to be in effect 
for all levels of future terminal sessions as well. 


Special Cases 


/SPOOLED-OUTPUT Switch 

You can give the special switch, /SPOOLED-OUTPUT, as sole 
argument to the PLOT command. This causes any spooled 
output accumulated so far during your terminal session to be 
placed in a plotter queue immediately, rather than at 
log-out time. The /SPOOLED-OUTPUT switch is useful only if 
the SET SPOOLED-OUTPUT DEFERRED command is in effect. 
Programs that you run (especially FORTRAN programs) create 
spooled output for the plotter, or you can create it 
directly by giving the command, COPY filespec PLT: . 


Effect on Memory and Terminal 


The PLOT command does not affect 
at TOPS-20 command level. 

Related Commands 

CANCEL 

INFORMATION OUTPUT-REQUESTS 

MODIFY 

SET DEFAULT PLOT 


memory and leaves your terminal 


for withdrawing PLOT requests 

for examining requests in the 
output queues 

for changing PLOT requests 

before processing has begun 

for establishing default 
switches for subsequent PLOT 
commands . 
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Examples 


1. Plot a file. 

@ PLOT CNTR. MED 

[Jab CNTR Queued t Request- I D 31 , Limit 2] 

e 


2. Send all files having a four-character file type ending in 
CTH" to the plotter. Assign a jobname to the request, and 
ensure they are not printed until tomorrow. Check" for the 
request in the output queues, and then cancel it. 


@ PLQT * t CTH /JDBNAME:HATCH/AFTER: TODAY 

[Job HATCH Queued » Request-ID 94 t Limit 3 > 3 Files] 

@ I NFORMAT I ON OUTPUT-REQUESTS 

Plotter Queue: 

Job Name Res# Limit User 


CNTR 91 2. LAUDERDALE 

HATCH 94 3 ASHLEY /Afte r:21-Jul-79 00:00 

There are 2 Jobs in the Queue (None in Progress) 


@ C ANCEL PLOT 94 
Cl Job Canceled] 
@ 
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Function 

The POP command terminates the current level of TOPS-20 and 
returns you to its superior process. 


Format 


@POP (COMMAND LEVEL) 


Characteristics 


POP the Opposite of PUSH 

You can do one and only one POP command for every previous 
PUSH command. Giving too many POP commands will cause an 
error message to be printed on your terminal. 

Job Parameters Affected by POP 

As soon as you complete a valid POP command at some level of 
TOPS-20 , you give up the copy of memory for that level of 
TOPS-20 and any program you were running. Any defaults 
established at that level (e.g., default filespecs for 
LOAD-class and EDIT-class commands, defaults specified by 
SET DEFAULT commands) are cancelled as well. If POP returns 
you to a higher level of TOPS-20, all these parameters 
revert to any values established at that higher level. 


Special Cases 


Returning to Other Programs With POP 

The POP command usually returns you to the level of TOPS-20 
from which you gave a previous PUSH command. But a few 
system programs, e.g., PTYCON and OPR, also allow you to 
give PUSH to get a new level of TOPS-20. Giving the POP 
command to this level of TOPS-20 returns you ' to that 
program. 


Effect on Memory and Terminal 


The POP command clears memory, terminates the current level of 
TOPS-20 , and returns your terminal to the previous TOPS-20 
command level (but see Special Cases, above) . Memory for the 
previous TOPS-20 command level is not affected by this action. 
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Related Commands 

CONTINUE for resuming execution of a program in memory 

PUSH for obtaining a new level of TOPS-20 


Examples 


1. Give the POP command to return to a higher level of the 
TOPS-20 command processor (EXEC) . 

II POP 
(I 

2. Run a program and halt it with CTRL/Cs. Give a CONTINUE STAY 
command to resume its execution, and then the PUSH command 
for a new level of TOPS-20. Run another program at this 
lower level, then use the POP command to return to the first 
level; in this case you return before receiving the final 
message of the first program. 

@ RUN DMN 
_C 

i CONTINUE STAY 
UPUSH 


TOPS-20 Command processor 4(555) 
U RUN TE5TF1 

THIS IS A TEST . 

END OF EXECUTION 

CPU TIME: 0.03 ELAPSED TIME: 0:72 
EXIT 
d PQP 
EXIT 
@ 
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PRINT 


Function 


The PRINT command places requests in a line printer output queue. 


Format 


0PRINT (FILES) /switch (es) f ilespec/switch (es) 

where 

switches are keywords, chosen from the list below, indicating 

your choice of PRINT command options. These 
switches are of two kinds: job switches and file 
switches . 

Job switches apply to all files specified in the 
command, no matter where you give the switches. 

File switches have different effects depending on 
their positions in the command file: placed before 
all files in the command, they act as defaults for 
all; otherwise they affect only the nearest 
preceding file. 

Defaults are shown in the list of switches 

filespec is the specification of a file you wish to print. 

You can use wildcard characters (% and *) to specify 
more than one file. 

, means that, after a comma, you can 'give more 
arguments of the form already shown 


225 



PRINT (Cont.) 


Summary of PRINT Command Switches (defaults in boldface) 


Job Switches 

(affecting the entire command) 


/ACCOUNT : account Default account - your current 

account 

/AFTERrdate and/or time 
/DESTINATION-NODE: node name 

/FORMS: forms name Default forms name - NORMAL 

/GENERIC 

/JOBNAME : 6-char acter name Default name - first six 

characters of first 
filename in request 

/LIMIT:n Default n - calculated from length 

of files 

/LOWERCASE 

/NOTE : 12-char acter message 
YES 

/NOTIFY: NO 

/PRIORITY:n Default n - 10 

/SEQUENCE : n 

/UNIT:octal number 

/UPPERCASE 

/USER: user name 


File Switches 

(affecting only the nearest preceding file, 
unless placed before all filespecs) 


/BEGIN : n 
/COPIES : n 
/DELETE 

ASCII 

COBOL 

/FILE : ELEVEN 
FORTRAN 


/HEADER 

ARROW 
ASCII 
/MODE: OCTAL 

SUPPRESS 

/NOHEADER 

/PRESERVE 


Default n - 0 
Default n - 1 

Default for files of type .LST 


Default for files of type .DAT 
only 


Default for all files except those 
of type .LST 


/REPORT: 12-character title 


SINGLE 
/SPACING: DOUBLE 
TRIPLE 
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PRINT Command Switches 
Job Switches 

(affecting the entire command) 

/ACCOUNT : account specifies the account of 39 or fewer 

characters to charge for your 
printing request. This account must 
be valid for your user name. 

Default account - your current 

account (check 
wi th 

INFORMATION 

JOB-STATUS) 

/AFTER:date and/or time, or 

day of week (or TODAY) 

and/or time ensures that the job will not be 

printed until after the date and/or 
time specified. NOV-12-79 and 18:00 
illustrate two arguments to this 
switch. If you give both date and 
time, separate them with a space. 
When given alone, the time may be 
preceded by a plus sign (+) , which 
will delay processing by the 
indicated length of time from the 
present . 

Alternatively, you can give a day of 
the week (such as, MONDAY) or TODAY 
as argument; then the job will not 
be printed until the beginning of the 
following day. If you follow this 
argument with a plus sign and a time, 
the job will be further delayed by 
this amount. 


/DESTINATION-NODE :node name:: 

specifies the DECnet node or IBM 
remote job entry (RJE) station on 
whose line printer your request is to 
be printed. The node name must be of 
six or fewer characters and must be 
followed by two colons (::). You can 
use this switch to either send output 
to an RJE station or redirect it from 
a DECnet RJE station. However, you 
cannot send output from one DECnet 
host system to another by using this 
switch . 
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PRINT Command Switches 

Job Switches 

(affecting the entire command) 

/FORMS:forms name specifies, in six or fewer 

characters, the forms (determining 
the number of banner, header, and 
trailer pages; the paper color, 
width, and weight; vertical format, 
carriage control tape, etc.) to use 
for the printing job. Using this 
switch may delay processing until the 
operator can mount the proper forms. 
Note that your installation may 
provide a different default argument 
to this switch. 

Default forms name - NORMAL 

/GENERIC allows any printer, either upper or 

lowercase, and of any unit number, to 
be used for satisfying the request. 
Use this switch to override a 
previous /UPPERCASE, /LOWERCASE, or 
/UNIT switch. 

Default 

/JOBNAME :name assigns a name (of six or fewer 

characters) to the printing job 

Default name - first six 

characters of 
first filename in 
the request 

/LIMITsn places a limit of n pages on the 

output of the printing job 

Default limits, usually 

adequate, are computed 

from the size of the 

files you want printed 

/LOWERCASE directs the job to a line printer 

that can print both uppercase and 
lowercase characters 

/NOTE :message labels the header page of output, 

i.e., the page displaying the 

jobname, with a message or notation 

of up to 12 characters. The message 
must be enclosed in double quotation 
marks if it contains spaces or 
non-alphanumer ic characters. 
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YES 

/NOTIFY: NO 


/PRIORITY : n 


PRINT Command Switches (Cont.) 


tells the system whether to send a 
message to your terminal when the 
request has been satisfied 

Default argument - NO 

Default argument (if switch is 
given) - YES 

assigns a number n, reflecting the 
urgency of the print request. This n 
must be from 1 to 63, with larger 
numbers receiving earlier treatment. 
Note that for non-pr ivi leged users 
the maximum priority that can be 
specified is lower (usually 20) , and 
that your installation may provide a 
different value both for this maximum 
and for the default priority. 

Default n - 10 
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PRINT Command Switches (Cont.) 


/SEQUENCE :n 


/UNIT:octal number 


/UPPERCASE 


/USERruser name 


specifies sequence number n for the 
printing request, which you can use 
when modifying or canceling the 
request 

directs your request to the line 
printer of the specified octal unit 
number 

directs the job to a line printer 
that uses only uppercase characters 

specifies the user who is to be the 
owner of the print request. For 
privileged users only. 


File Switches 

(affecting only the nearest preceding file, 
unless placed before all file specifications) 


/BEGIN : n 

starts the printing at 
file 

page n 

of 

the 


Default n - 0 




/COPIES : n 

requests that n copies 

of the 

file 

be 

printed; n must be 

equal to 62. 

less 

than 

or 



Default n - 1 


/DELETE 


deletes the file after 
Default for files 


pr inting 
of type . LST 


ASCII 

COBOL 

/FILE: ELEVEN 
FORTRAN 


/HEADER 


specifies that the file consists of 
ASCII text, or COBOL SIXBIT text; or 
(ELEVEN) contains four eight-bit 
bytes in each 36-bit word - for 
emulating paper tape punch only; or 
is FORTRAN ASCII text, where column 1 
of each line is interpreted as a 
carriage control character. 

Default - ASCII (except for 
files of type .DAT, 
for which the default 
is FORTRAN) 

causes header pages containing the 
jobname to be printed before the file 
itself 

Default 
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PRINT Command Switches (Cont.) 


ARROW 
ASCII 
/MODE : OCTAL 

SUPPRESS 


/NOHEADER 


designates the mode for printing the 
file. ARROW prints the file 
literally, but denotes each control 
character by an up-arrow (~) and the 
character, except for the following, 
which are printed literally: 
carriage return, linefeed, horizontal 
tab, vertical tab, and formfeed. 
ASCII prints the file literally, 
without omissions or substitutions. 


OCTAL prints each word in the file as 
unsigned octal integers; 3 groups of 
128 words (8 rows of 16 columns each) 
appear on a standard line printer 
page. SUPPRESS prints the file 
without any blank lines, causing all 
vertical format characters (CTRL/K, 
CTRL/L, CTRL/O, CTRL/R, CTRL/S, and 
CTRL/T) to be converted to CRLFs 
(carriage return/linefeeds) , and then 
interpreting multiple occurrences of 
CRLFs as a single CRLF. 

Default - ARROW 


prevents the printing of header pages 
before the file 


/PRESERVE 


/REPORT: title 


SINGLE 
/SPACING: DOUBLE 
TRIPLE 


saves the file after printing 

Default for all files except 
those of type . LST 

scans your files and prints only 
those lines whose first characters 
are the title you give. This title 
may contain up to 12 characters 
(including the quotation marks that 
must enclose the title if it contains 
spaces) . The switch is used along 
with the COBOL report writer. 


determines the spacing between lines 
in the printout 

Default - SINGLE 


Output 


Jobname, Request ID, Limit, Number of Files 

As soon as you complete a valid PRINT command, the system 
responds by printing, on your terminal, the jobname, request 
ID number, the limit in pages of output assigned to the 
request, and the number of files in the request. 
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Characteristics 


Ordinary Operation - No Switches 

For most purposes you can use the PRINT command with just a 
series of filespecs for arguments. 

Switch Defaults Set by System Manager 

The defaults shown in the list of switches are correct for 
most user sites. However, your system manager can change 
some of those default settings. The switches most commonly 
affected are: /FORMS, /HEADER and /NOHEADER, /LIMIT, and 

/PRIORITY. 


Hints 


Using SET DEFAULT PRINT 

If there are switches that you always or usually supply when 
using PRINT, give the SET DEFAULT PRINT command to establish 
them as defaults (at the current TOPS-20 command level) for 
the remainder of your terminal session. The switches will 
then behave as if you had typed them directly after the 
command name. You can supersede any of these default 
switches by actually supplying the switch, with another 
value, when you give the PRINT command. Put SET DEFAULT 
PRINT into a file of specification COMAND.CMD in your log-in 
directory if you want these default switches to be in effect 
for all levels of future terminal sessions as well. 


Special Cases 


/SPOOLED-OUTPUT Switch 

You can give the special switch, /SPOOLED-OUTPUT, as sole 
argument to the PRINT command. This causes any spooled 
output accumulated so far during your terminal session to be 
placed in a line printer queue immediately, rather than at 
log-out time. The /SPOOLED-OUTPUT switch is useful only if 
the SET SPOOLED-OUTPUT DEFERRED command is in effect. 
Programs that you run (especially FORTRAN programs) create 
spooled output for the printer, or you can create it 
directly by writing to device LPT: (e.g., by giving the 
command, COPY filespec LPT:), or giving a CREF command. 


Effect on Memory and Terminal 

The PRINT command does not affect memory and leaves your terminal 
at TOPS-20 command level. 
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Related Commands 


CANCEL 

INFORMATION OUTPUT-REQUESTS 


MODIFY 


SET DEFAULT PRINT 


Examples 


1. Print two of your files. 

S PRINT 4-UPED.TXT > CMPTN.TXT 

[Job 4 - U P E D Queued » Resuest-ID 3 0 2 » Limit 2 0 0 > 2 Files] 

@ 

2. Print three files, assigning a jobname and a note for the 
header page; postpone the printing. Make 4 copies of one of 
the files, and double-space another one. 

S PRINT / JOBNAME : CQMFIL/NQTE : CDNFIDENTI ftL/AFTER : 1 2-DEC-79 FQO 
. CTL ) HQLMAX.CTL/CQPIES:4 > I NS I DE . RNO/ 5 PflC I NG : DOUBLE 
[Job COMFIL Queued » Resuest-ID 3 0 G > Limit 27» 3 Files] 

@ I NFORMAT I ON OUT PUT - RE QUESTS / USER / ALL 

Printer Queue: 

Job Name Res# Limit User 


COMFIL 30G 27 LATTA / Af t e r : 1 2- De c -79 0:00 

/Note CONFIDENTIAL /Ses:18G5 
There is 1 Job in the Queue (None in Pro Jress) 

@ 

3. Print a job in a hurry, by assigning a high priority and 
skipping the header and first five pages. Print 10 copies of 
the first file, and 18 of the second. 

@ PR INT / JOBNAME: RUSH / PR ID R IT Y: GO /NOHEADER /BEGIN 55/COPIES si 
0 RFM.CTL t HOLMAX.CTL/CDPIES: 18 

[Job RUSH Queued » Resuest-ID 3 1 2 > Limit 27 i 2 Files] 

B INFDRMATIDN DU T P U T - REQU E 5 TS /USER/ALL 

Printer Queue: 

Job Name Res# Limit User 


* RUSH 312 27 LATTA On Un i t : 0 /Prio:20 

/Ses: 1870 

Started at 15:00:11 > printed 10 of 27 Fades 
CDMFIL 30 G 27 LATTA / Af t e r : 1 2-D e c - 79 0:00 

/Note CONFIDENTIAL /Ses:18G5 
There are 2 Jobs in the Queue (1 in Prodress) 

@ 


for withdrawing PRINT requests 

for examining requests in the 
output queues 

for changing PRINT requests 
before processing has begun 

for establishing default switches 
for subsequent PRINT commands 
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PUNCH 


Function 


The PUNCH command places requests in a card punch or paper tape 
punch output queue. 


Format 


@PUNCH (ONTO) medium (FILES) /switch (es) f ilespec/switch (es) , . . . 


where 

medium 


switches 


f ilespec 


is the name of the medium on which you want to 
punch your file(s) . It can be either 

CARDS 

or 

PAPER-TAPE 

are keywords, chosen from the list below, 
indicating your choice of PUNCH command options. 
These switches are of two kinds: job switches and 
file switches. 

Job switches apply to all files specified in the 
command, no matter where you give the switches. 

File switches have different effects depending on 
their positions in the command line: placed 
before all files in the command, they act as 
defaults for all; otherwise they affect only the 
nearest preceding file. 

Defaults are shown in the list of switches 

is the specification of a file you wish to punch. 
You can use wildcard characters (% and *) to 
specify more than one file. 

means that, after a comma, you can give more 
arguments of the form already shown 
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Summary of PUNCH Command Switches (defaults in boldface) 


Job Switches 
(affecting the entire command) 

/ACCOUNT: account Default account - your current 

account 

/AFTER : date and/or time /DESTINATION-NODE : node-name 


/FORMS: forms name 
/GENERIC 

/JOBNAME : 6-char acter name 


/LIMIT: n 

/METERS :n (PAPER-TAPE only) 

/NOTE : 12-character message 
YES 

/NOTIFY: NO 
/PRIORITY: n 
/SEQUENCE : n 
/UNIT:octal number 
/USER:user name 


Default forms name - NORMAL 

Default - first six characters 
of first filename in 
request 

Default n - calculated from 

length of files 

Default n - calculated from 

length of files 


Default n - 10 


File Switches 

(affecting only the nearest preceding file, 
unless placed before all filespecs) 


/COPIES :n 

/DELETE 

/HEADER 

ASCII 

BCD 

/MODE: BINARY (CARDS only) 
IMAGE 


Default n - 1 

Default for files of type . LST 


ASCII 

BINARY 

/MODE: IMAGE (PAPER-TAPE only) 

IMAGE-BINARY 

/NOHEADER 

/PRESERVE Default for all files except 

those of type .LST 
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Job Switches 

(affecting the entire command) 


/ACCOUNT:account specifies the account of 39 or fewer 

characters to charge for your punching 
request. This account must be valid for 
your user name. 

Default account - your current 

account (check 
with INFORMATION 
JOB-STATUS) 


/AFTERrdate and/or time or 

day of week (or TODAY) 

and/or time ensures that the job will not be punched 

until after the date and/or time 

specified. NOV-12-79 and 18:00 

illustrate two arguments to this switch. 

If you give both date and time, separate 
them with a space. When given alone, 
the time may be preceded by a plus sign 
(+) , which will delay processing by the 
indicated length of time from the 

present . 

Alternatively, you can give a day of the 


week (e. 

g. , 

MONDAY) or TODAY 

as 

argument ; 

then 

the 

job will not 

be 

punched 

until 

the 

beginning of 

the 

following 

day . 

If 

you follow 

this 


argument with a plus sign and a time, 
the job will be further delayed by this 
amount . 

/DESTINATION-NODE mode name:: 

specifies the DECnet network node on 
whose card punch or paper tape punch 
your request is to be satisfied. The 
node name must of six or fewer 
characters and must be followed by two 
colons ( : : ) . 

/FORMS : forms name specifies, in six or fewer characters, 

the forms (determining the weight and 
color of card or paper stock, the size 
of banner, header, and trailer sections, 
etc.) to use for the punching job. 
Using this switch may delay processing 
until the operator can mount the proper 
forms. Note that your installation may 
provide a different default argument to 
this switch. 

Default forms name - NORMAL 

/GENERIC allows any card punch or paper tape 

punch to be used for satisfying the 
request; use this switch to override a 
previous /UNIT switch. 

Default 
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/JOBNAME : name 

/LIMIT: n 

/METERS :n 
/NOTE :message 

YES 

/NOTIFY: NO 

/PRIORITY: n 


/SEQUENCE : n 

/UNIT:octal number 

/USER:user name 


Job Switches (Cont.) 


assigns a name (of six or fewer 
characters) to the punching job 

Default name - first six characters 
of first filename 
in the request 

places a limit of n cards (or n feet of 
paper tape) on the output of the 
punching job 

Default limits, usually adequate, 
are calculated from the 
size of the files you want 
punched 

places a limit of n meters on the output 
of the punching job (PAPER-TAPE only) 

labels the header section of output, 
i.e., the section displaying the 
jobname, with a message or notation of 
up to 12 characters. The message must 
be enclosed in double quotation marks if 
it contains spaces or non-alphanumer ic 
characters . 


tells the system whether to send a 
message to your terminal when the 
request has been satisfied 
Default argument - NO 

Default argument (if switch is 
given) - YES 

assigns a number n, reflecting the 
urgency of the punch request. This n 
must from 1 to 63, with larger numbers 
receiving earlier treatment. Note that 
for non-pr ivileged users the maximum 
priority that can be specified is lower 
(usually 20) , and that your installation 
may provide a different value both for 
this maximum and for the default 
pr ior ity . 

Default n - 10 

specifies sequence number n for the 
punch request, which you can use when 
modifying or canceling the request 

directs your request to the card punch 
or paper tape punch of the specified 
octal unit number 

specifies the user who is to be the 
owner of the punch request. For 
privileged users only. 
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File Switches 

(affecting only the nearest preceding file, 
unless placed before all file specifications) 


/COPIES:n requests that n copies of the file be 

punched; n must be less than or equal 
to 62 . 

Default n - 1 

/DELETE deletes the file after punching 

Default for files of type . LST 

/HEADER causes a header section containing the 

jobname to be punched before the file 
itself is produced 

Default 

ASCII 

BCD 

/MODE : BINARY (CARDS only) 

IMAGE designates the mode for punching the 

file onto cards. ASCII treats each word 
of a disk file as five seven-bit bytes 
and punches each byte into one column of 
the card, using the ASCII translation 
table for conversion into Hollerith 
code. BCD is the same as ASCII, except 
that it uses the 026 translation table. 
BINARY treats each group of 26 words as 
78 12-bit bytes and punches each byte 
into one column of the card, from column 
3 through column 80; column 1 contains 
the octal word count in rows 12 through 
3 and rows 7 and 9 punched, while column 
2 contains a 12-bit folded checksum. 
IMAGE treats each group of 27 words as 
81 12-bit bytes and punches each byte 
into one column of the card, ignoring 
the eighty-first byte. 

ASCII 

BINARY 

/MODE: IMAGE (PAPER-TAPE only) 

IMAGE-BINARY designates the mode for punching the 

file onto paper tape. ASCII treats each 
word of a disk file as five seven— bit 
bytes plus an even parity bit for each 
byte, and punches each byte into one 
frame of paper tape; if a vertical or 
horizontal tab is punched, it is 
followed by a rubout character, and if a 
formfeed is punched, it is followed by 
16 null characters. BINARY treats each 
group of 33 words as 1 control word 
followed by 32 words of data, where each 
word (both control and data) consists of 
six 6-bit bytes, and punches each byte 
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File Switches (Cont.) 


into one frame of paper tape after 
adding 200 (octal) to the byte; the 
control word consists of a folded 
checksum in the left half and the data 
word count in the right half. IMAGE 
treats each word of a disk file as one 
8-bit byte followed by 28 zeroes, and 
punches each byte into one frame of 
paper tape. IMAGE BINARY treats each 
word as six 6-bit bytes, and punches 
each byte into one frame of paper tape 
after adding 200 (octal) to each byte. 

/NOHEADER prevents the punching of a header 

section before the file 

/PRESERVE saves the file after punching 

Default for all files except those 
of type . LST 

Output 


Jobname, Request ID, Limit, Number of Input Files 

As soon as you complete a valid PUNCH command, the system 
responds by printing, on your terminal, the jobname, request 
ID number, the output limit in number of cards or feet of 
paper tape assigned to the request, and the number of input 
files in the request. 


Characteristics 


Ordinary Operation - No Switches 


For most purposes you can use the PUNCH command with just 
the medium and a series of filespecs for arguments. 

Switch Defaults Set by System Managers 


The defaults shown in the list of switches are correct for 
most user sites. However, your system manager can change 
some of those default settings. The switches most commonly 
affected are; /FORMS, /HEADER and /NOHEADER, /LIMIT, and 
/PRIORITY. 
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Hints 


Using the SET DEFAULT Commands 

If there are switches that you always or usually supply when 
using PUNCH, give the SET DEFAULT CARDS or SET DEFAULT 
PAPER-TAPE command to establish them as defaults (at the 
current TOPS-20 command level) for the remainder of your 
terminal session. The switches will then behave as if you 
had typed them directly after the command name. You can 
supersede any of these default switches by actually 
supplying the switch, with another value, when you give the 
PUNCH command. Put SET DEFAULT commands into a file of 
specification COMAND.CMD in your log-in directory if you 
want these default switches to be in effect for all levels 
of future terminal sessions as well. 


Special Cases 


/SPOOLED-OUTPUT Switch 

You can give the special switch, /SPOOLED-OUTPUT, as sole 
argument 'to the PUNCH CARDS or PUNCH PAPER-TAPE command. 
This causes any spooled output accumulated so far during 
your terminal session to be placed in a card punch or paper 
tape punch queue immediately, rather than at log-out time. 
The /SPOOLED-OUTPUT switch is useful only if the SET 
SPOOLED-OUTPUT DEFERRED command is in effect. Programs that 
you run (especially FORTRAN programs) create spooled paper 
tape punch or card punch output. Or you can create it 
directly by giving the command, COPY filespec PTP:, or COPY 
filespec CDP: , respectively. 


Effect on Memory and Terminal 


The PUNCH command does not affect memory and leaves your terminal 
at TOPS-20 command level. 


Related Commands 


CARDS 

CANCEL PAPER-TAPE for withdrawing PUNCH requests 

INFORMATION OUTPUT-REQUESTS 

for examining requests in the output 
queues 

CARDS 

MODIFY PAPER-TAPE for changing PUNCH requests before 

processing has begun 

CARDS 

SET DEFAULT PAPER-TAPE for establishing default switches for 

subsequent PUNCH commands 
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Examples 


1. Punch a file onto cards. 

B RUNCH CARDS ESTMT.DAT 

[Job E S T M T Queued* R e s u e s t - I D 1 4 B > Limit 303 
0 

2. Punch a file onto paper tape. 

B RUNCH PAPER-TAPE REAUMUR. LNS 

[Job REAUMU Queued » Resuest-ID 12 > Limit 553 

B 

3. Punch three files onto paper tape, specifying a particular 
paper tape punch for two of them and allowing the third to be 
punched on any available device. 

B RUNCH PAPER-TAPE /UNIT:2 INDX.LTG* P0N.LG4/GENERIC > - 
BENNETT .TXT 

[Job I NDX Queued* Res ue s t - I D 1 49 ) Limit 110) 3 Files! 

B 

4. Punch a file onto paper tape, specifying that the job not 
begin for an hour. Check for your requests in the output 
queues, then cancel both of your paper tape requests. 

B PUNCH PAPER-TAPE FORUM. APR / AFTER : + 1 : 00 
[Job FORUM Queued) Res ue s t - I D 150) Limit 103 
B INFORMAT I ON OUTPUT -REQUESTS /USER 


Pape rtape 

Q u e u e 

: 


Job Name 

Res# 

Limit 

User 

I NDX 

149 

110 

SCARNY 

FORUM 

150 

10 

SCARNY / Afte r:20-Jul-79 16:2 

There are 

2 Jobs 

in the 

Queue (None in P r o 3 r e s s ) 


C a r d - P u n c h Q u e u e : 

Job Name Res# Limit 

User 

ESTMT 146 30 

5CARNY 


There is 1 Job in the Queue (None in ProJress) 
B C ANGEL PAPER-TAPE * 

[2 Jobs Canceled! 

0 
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Function 

The PUSH command creates a new level of TOPS-20 inferior to the 
one from which you give the PUSH command. 


Format 


@ PUSH (COMMAND LEVEL) 

Characteristics 


A New Level of TOPS-20 

The PUSH command creates a lower TOPS-20 command level 
(EXEC) than you were using. The file of specification 
COMAND.CMD in your log-in directory is executed again, you 
have a fresh copy of memory and can begin giving commands as 
if you had just logged in. However, job-wide parameters 
(e.g., connected and accessed directories, logical name 
definitions, most parameters altered by SET commands) are 
unaffected by the PUSH command and retain their values from 
just before PUSH. 


Hints 


Using CONTINUE STAY With PUSH 

You can use the PUSH command to run two programs at once or 
to do other work that requires more than one copy of memory. 
Simply use the CONTINUE STAY command to continue execution 
of your current program before using PUSH. After PUSH you 
can run another program or otherwise alter memory without 
affecting memory for the first program. See Example 2. But 
see also Warning, below. 


Restr ictions 


Number of Successive PUSH commands 

You can give as many pairs of PUSH and POP commands as 
necessary to complete your task. Although there is a limit 
to the number of times you can give PUSH without giving 
intervening POP commands, this limit is large enough 
(approximately 24, although smaller for a heavily loaded 
system) not to interfere with most applications. 
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Withheld Log-out Capability 

You can usually log out from a lower level of TOPS-20 than 
the one to which you logged in. By doing so, you 
simultaneously conclude all processes of your job. However, 
if a program (e.g., PTYCON) has initialized a level of the 
TOPS-20 command processor but has withheld log-out 
capability from it, you must use the POP command, followed, 
if necessary, by a program command to exit from the program 
and return to a higher level of TOPS-20, before you can log 
out . 


Warning 


Competition Between Processes 

If you have two programs running at once after using 
CONTINUE STAY and PUSH commands (see Hints, above) they may 
try to access the same files at the same time. Or, TOPS-20 
commands given at the lower level may be intercepted by a 
program running at the higher level. For a discussion of 
these possibilities, see the Restrictions section of the 
CONTINUE command description. 


Effect on Memory and Terminal 


The PUSH command preserves your present memory, gives you a fresh 
copy of memory, and leaves your terminal at a new TOPS-20 command 
level . 


Related Commands 


CONTINUE STAY for beginning execution of a program before 
giving the PUSH command 

pop for returning to a previous level of TOPS-20 


Examples 


1. Give the PUSH command. 

@PjJSH 

TOPS-20 C o mm a ri d processor 4(555) 

@ 
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2. Run a program, and give a CTRL/C to return to TOPS-20 command 
level. Give a CONTINUE STAY command to resume this program's 
execution, and then a PUSH command for a new copy of the 
TOPS-20 command language. Repeat this process twice; now 
you have three programs running at once. In the lowest 
(fourth) level of your job, begin editing a file. (Note; 
when running more than one program in this way, be sure that 
they do not use the same compiler or the same data base; 
otherwise, competition among them could cause unpredictable 
situations to develop.) 

B RUN TE5TF1 
_C 

B CONTINUE STAY 
@ PUSH 

TOPS-20 Command processor 4(555) 

@ RUN DMN 

_C 

e CONTINUE STAY 
SPUSH 


T □ P S - 2 0 Command processor 4(555) 
B RUN PRQDUK 
j_C 

B CONTINUE STAY 
BRUSH 


TOPS-20 Command processor 4(555) 
B EDIT ART I F I . CTL 
Edit: ART I F I .CTL. 7 
* 
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R 


Function 


The R command places in memory and starts an executable program. 


Format 


@R (PROGRAM) f ilespec/switch 
where 

filespec is the file specification of any executable program 

Default dev : <d irectory> - SYS: 

Default .typ - .EXE 

/switch is /USE-SECTION :n 

specifies the memory section (from 0 to 37 
octal) in which your program is to run. You 
can use this switch only if your program can 
be contained in one section. 


Characteristics 


Necessity of R Command 


Although in most cases you can run 
simply typing the program name 
command, the R command is necessary 
whose name is the same as a TOPS-20 


executable programs by 
in place of a TOPS-20 
for running a program 
command . 


Hints 


Defining SYS: 


If you redefine logical name SYS: to be different f 
system-wide definition, you should include SYS: 
search list if you want to use the R command to run 
programs. For further information, refer to the 
entitled, "Redefining System Logical Names," in the 
command description. 


rom the 
in the 
system 
section 
DEFINE 


TOPS-20 Version 5 
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Effect on Memory and Terminal 


The R command clears memory and terminates the current process, 
then places in memory and starts the specified program, and 
leaves your terminal at command level in the program (if any), or 
at TOPS-20 command level. 


Related Commands 

INFORMATION LOGICAL-NAMES 

RUN 


for examining the definition of 
SYS: 

for running executable user 
programs 


Examples 


1. Run the FILCOM system program. 

@ R FILCOM 
* 

2. Find out what APL programs are available in logical name 
SYS:. Run one of them. 

@ D I RECTORY SYS ; *APL* . EXE 

PS:<FIELD-IMAGE> 

APL. EKE. 1 
APLSF.EXE. 1 
MAPLFL.EXE. 1 

Total of 3 files 
@ R APL. EXE 
TERMINAL. . 
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RECEIVE 


Function 


The RECEIVE command notifies the system that you are willing to 
accept communication links, or advice from another user, or 
system messages. 


Format 


@ RECEIVE argument 

where 

argument is a keyword, chosen from the list below, 

naming the kind of communication you are 
willing to accept 


RECEIVE Command Arguments 


LINKS 

ADVICE 


SYSTEM-MESSAGES 


allows communication links established by 
another user's TALK command 

allows both assistance and communication 
links initiated by another user's ADVISE or 
TALK command 

allows messages of interest to all users sent 
by the operator or other privileqed users 
Default - LINKS 


Hints 


Typing RECEIVE During Attempted TALK 

If your terminal has been set to refuse links and another 
user tries to talk to you by using the TALK command, both 
terminals will give a series of CTRL/G signals (ringing 
bells or high-pitched beeps) indicating the refused attempt. 
If you give the RECEIVE LINKS command before these signals 
are finished, the TALK command will succeed. 


Effect on Memory and Terminal 


The RECEIVE command 
terminal at TOPS-20 


does not affect 
command level. 


memory 


and 


leaves your 
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Related Commands 


ADVISE 

INFORMATION TERMINAL-MODE 

REFUSE 

TALK 

Examples 


for sending commands to another 
user ' s job 

for examining your current terminal 
settings 

for refusing communication links, 
advice, or system messages 

for sending comments to another 
user 


1. Give the RECEIVE command to accept communication links from 
other users. 

B RECEI VE LINKS 

e 

2. Set your terminal to receive links, at the request (sent via 
the MAIL program, not shown here) of another user. Begin a 
communication session with this user, during which you give 
the RECEIVE ADVICE command also, to allow a demonstration of 
the UDP program. Afterwards, set your terminal again to 
refuse advice. 

B RECEI VE 
B 

LINK FROM RENDU I ST » TTY 127 

B iTHANKS , BUT IF YOU LET ME DO AN "ADVISE" I CAN SHOW YDU 
@ ; HOW TO RUN THE PROGRAM BY ACTUALLY DOING IT. OKAY? 

@ ; SURE . I 'LL FIX MY SETTING . 

B RECEIVE ADVICE 
BADVISE LATTA 

Escape character is <CCTRL)E» type < CTRL.- 1, ? far help 

LATTA , M I S C : < L A T T A > Job 33 EXEC 

[AdvisinS] 

UDP 

UDP>LIST/DOCUMENTATION: /CREATED- SINCE : 1 - 1 -78 0:0 
UDP > EXIT 

BiYOU'LL GET A PRINTED LISTING TOMORROW. 

B i DO YOU SEE HOW I DID IT? 

B i YES > THANKS . GOODBYE. 

B 

[Advice terminated! 

B REFUSE ADVICE 
B 
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REENTER 


Function 


The REENTER command starts your currently loaded program at its 
alternate entry point. 


Format 


@ REENTER (PROGRAM) 


Characteristics 


Using REENTER 

The REENTER command starts your program at the address 
specified by the second word in the program's entry vector. 
For most programs this address is contained in location 124. 
Usually the REENTER and START commands start the program at 
the same point, but another re-entry point can be provided 
to avoid initialization procedures, perform error recovery, 
or to use the program in a different way. 


Hints 


Further Information 

For more information about entry vectors, see the TQPS-20 
Monitor Calls Reference Manual. 


Effect on Memory and Terminal 


The REENTER command does not affect memory and leaves your 
terminal at a level determined by the program. 


Related Commands 


GET 

for 

LOAD 

for 

START 

for 


placing an executable program in memory 
loading a source or object program into memory 
entering a program at its normal entry point 
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Examples 


1. Give the REENTER command for your current program. 
i REENTER 

2. Begin running a program, then give a CTRL/C to leave it and 
obtain a file. Resume execution of the program at the 
alternate entry point. 

@ R DUMPER 

dumper>- c 

B ACCESS P S ; < P . S P E C C I N I > 

P a s s w o r d : 

@ C 0 P Y PS;<P.SPECCINI>USR.FIL 
PS:<P.SPECCINI>USR.FIL. 1 => USR.FIL. 1 [OKI 
B END-ACCESS PS: < P , SPECCINI > 

B REENTER 

dumper:;- 
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Function 


The REFUSE command notifies the system that you are not willing 
to accept communication links, or advice from another user, or 
system messages. 


Format 


0REFUSE argument 

where 

argument is a keyword, chosen from the list below, 

naming the kind of communication you are not 
willing to accept 


REFUSE Command Arguments 


LINKS 


ADVICE 


prevents both assistance and communication 
links from being established by another 
user's ADVISE or TALK command 

prevents assistance initiated by another 
user's ADVISE command 


SYSTEM-MESSAGES prevents messages of general interest sent to 

all users by the monitor or by the operator 
or other privileged users 

Default - LINKS and ADVICE 


Hints 


Typing RECEIVE During Attempted TALK 

If your terminal has been set to refuse links and another 
user tries to talk to you by using the TALK command, both 
terminals will give a series of CTRL/G signals (ringing 
bells or high-pitched beeps) indicating the refused attempt. 
If you give the RECEIVE LINKS command before these signals 
are finished, the TALK command will succeed. 

REFUSE to Safeguard Terminal Output 

If you want your terminal to print a long file, say, without 
interference, use REFUSE LINKS and REFUSE SYSTEM-MESSAGES 
commands to prevent all classes of message from being 
received. Be sure to use the RECEIVE command afterwards to 
restore the previous condition of your terminal. 
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Special Cases 


Implicit Refusal of Advice 

If you give the REFUSE LINKS command, your terminal will be 
set to refuse advice also. However, the INFORMATION 
TERMINAL-MODE command may not display this setting unless 
you give an explicit REFUSE ADVICE command as well. 

Privileged Disregard of REFUSE 

A user with enabled Wheel or Operator capabilities can give 
the TALK or ADVISE command for any job. 


Effect on Memory and Terminal 


The REFUSE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


INFORMATION TERMINAL-MODE for examining your current terminal 

settings 

RECEIVE for receiving communication links, 

advice, or system messages 


Examples 

1. Use the REFUSE command to prevent other users from advising 
your job. 

B REFU5E ADVICE 
@ 

2. Receive a communication link formed by another user's TALK 
command. Confer with him briefly, then set your terminal to 
refuse all classes of message over which you have control. 

LINK FROM RENQUIST » TTY 127 

@;hello DAD ID. can you help me with edit? 

@ i SORRY i PLEASE BREAK. I 'M EXPECTING PRINTOUT AND THIS 

@ ;will interfere, will get in touch later. 

@ 5 OKAY 
BBREAK 

H REFUSE add ice 
B REFUSE LINKS 
@ REFUSE SYSTEM-MESSAGES 
@ 
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REMARK 


Function 


The REMARK command tells the system to regard the terminal input 
that follows as comment only. 


Format 


@ REMARK (MODE) 

Type remark. End with CTRL/Z . 


Characteristics 


Ending Remarks 

Until you give a CTRL/Z, the system merely displays what you 
type, instead of trying to interpret it as commands. 


Hints 


Useful During TALK or ADVISE Session 

If you have already established contact with another user by 
a TALK or ADVISE command before giving REMARK, his terminal 
will also display what you type. Give the REMARK command 
before sending lengthy comments or demonstrating commands 
that you don't want to take effect. 


Effect on Memory and Terminal 


The REMARK command does not affect memory and leaves your 
terminal at remark level. 


Related Commands 


ADVISE 

for 

sending 

commands 

to 

another user's job 

TALK 

for 

sending 

comments 

to 

another user 
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Examples 


1. Give the REMARK command. 

B REMARK 

TYPE REMARK. END WITH CTRL/Z . 

2. Receive a communication link from another user. Give the 
REMARK command to speak with him. Give a CTRL/Z afterwards 
to end the remarks. 

i 

LINK FROM P.SPECCINI , TTY 127 

@ i WHERE ARE THE NOTES FROM THE LAB DEMO THIS A.M.? 

6 REMARK 

TYPE REMARK. END WITH CTRL/Z . 

HI , PAUL. THEY'RE IN THE LAB'S LIBRARY AREA. 

THAT'S CHEM i < P-CHEM . 20 . NQTES> . I DON'T KNOW 
THE TITLE BUT LOOK AT THE DATES WITH A 
TDIRECTORY COMMAND . OKAY? 

; YES. THANKS. BYE 
BBREAK 


@ 
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RENAME 


Function 


The RENAME command changes the specification of a file. 


Format 


©RENAME (EXISTING FILE) old filespec(s) (TO BE) new filespec 
where 

old filespec(s) is a single file specification, or a series 

of them separated by commas and/or indicated 
by wildcard characters (% and *) 

new filespec is the new specification under which you want 

to store the file(s); you may include an 
asterisk (*) if you gave more than one old 
filespec . 

Default new filespec - old filespec, but 
with a generation number higher 
by 1 than the highest existing 
generation number 


Output 


Status of Files 

If you use recognition on the new file specification, the 
system prints !01d Generation!, !New Generation!, or !New 
File!, to describe its status. 

Confirmation of Action 

As each file is renamed, the sytem prints its old and new 
specification, and the word [Superseding] if it is replacing 
previous contents, and finally the word [OK]. The delay 
before you see this [OK] indicates how long it took to 
rename the file. 


Characteristics 


Efficiency of RENAME 

The RENAME command is the fastest and most efficient means 
of transferring files from one specification to another 
within a structure, because only the file specifications 
have to be changed - the contents are not copied. 
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Hints 


Specifying a 


New Account and Protection Number 


You can specify the new file's protection number and the 
account to which its storage fees will be charged. Follow 
the new filespec with a semicolon (;) and the letter P 
before giving a new 6-digit protection number, and with a 
semicolon and the letter A before giving a new account. 
Ordinarily these values are set to the default file 
protection and current account. However, non-default 
protection numbers will be maintained for higher generations 
of existing files, unless you specify otherwise in the 
RENAME command that creates that higher generation. 


Restrictions 


Renaming Between Structures 

You cannot rename a file from one structure to another, but 
must use the COPY command to reproduce its contents on the 
new structure, then the DELETE command to remove it from the 
old structure. 

Renaming Open or Mapped Files 

You cannot rename a file that is open or mapped into memory. 
First give the RESET command, or POP followed by RESET, if 
this is the case. 

Renaming Archived Files 

You can rename an archived file by specifying it as the 
first (or old) argument of a RENAME command. It will then 
have the second (or new) argument as its specification and 
will remain an archived file. However, you cannot give the 
specification of an archived file as the second argument of 
a RENAME command, as this would replace the file's contents. 
If you attempt to do so, the file you specify as the first 
argument will be renamed to a generation higher by 1 than 
the highest existing generation of the archived file, 
leaving the archived file intact. 


Warning 


Replacing Previous Contents of Files 

If you rename a file into a specification (including 
generation number) that already exists, the previous 
contents of the new file are replaced and cannot be 
recovered. But see Restrictions - Renaming Archived Files, 
above . 


255 



RENAME (Cont.) 


Effect on Memory and Terminal 


The RENAME command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


COPY for making copies of files 


Examples 


1. Rename a file. 

B RENAME ATM - 50 , S PC ATM-50. PRL 
ATM - 50 . S PC. 1 => ATM-50. PRL.l [OK] 

B 

2. Use a wildcard character to rename all files of a given name. 

B RENAME ATM-50.* l-ATM-50,* 

ATM-50. BAK.l => 1 -ATM-50 . BAK . 1 [OK] 

ATM-50. PRL.l => l-ATM-50. PRL. 1 [OK] 

B 

3. Access another user directory and transfer to it the files 
renamed in Example 2. 

B ACCESS (ORBEN > 

P a s s u o r d : 

B RENAME l-ATM-50.* (ORBEN > 
l-ATM-50. BAK. 1 = >< ORBEN > 1 - ATM - 50 . BAK . 1 [OK] 
l-ATM-50. PRL. 1 => <0RBEN>1-ATM-50.PRL. 1 [OK] 

B END- ACCESS (ORBEN) 

B 
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RESET 


Function 

The RESET command terminates the current process and all inferior 
processes . 

Format 

@RESET 

Characteristics 


Action of RESET 

The RESET command, in addition to clearing memory for the 
processes it terminates, closes all files, even if mapped, 
opened by the current process and all of its inferiors. It 
simultaneously terminates all lower processes. 


Effect on Memory and Terminal 


The RESET command clears memory for the current process and 
leaves your terminal at TOPS-20 command level. 


Related Commands 

INFORMATION FILE-STATUS for determining which files are 

currently open 

INFORMATION MEMORY-USAGE for determining contents of memory 


Examples 


1. Give the RESET command to clear memory. 

@ RESET 
@ 
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RETRIEVE 


Function 


The RETRIEVE command restores an off-line file (magnetic tape 
copy of a file) to disk. 


Format 


@ RETRIEVE (FILES) filespec,... 


where 

filespec is the specification of any off-line file 

(archived or not, visible or invisible) to 
which you have access; you may include 
wildcard characters (% and *) . 

/••• means that, after a comma, you can give 

more arguments of the form already shown 


Output 


Acknowledgment of Request 

As soon as you complete a valid RETRIEVE command, the system 
responds by printing, on your terminal, the specification of 
each off-line file for which you requested retrieval, 
followed by [OK] . 

Notice of Retrieval Sent to Requestor 

When the files for which you have requested retrieval have 
been restored to their directory on disk, a message is sent 
to the file MAIL.TXT in your log-in directory. This message 
gives the complete specification of each retrieved file. 
Read it using the RDMAIL or MS program. Remember that, 
depending on how frequently your site processes retrieval 
requests, this message may not be sent until one or more 
days after your request. 


Characteristics 


Invisibility of Retrieved Files 


If you retrieve invisible files, they will remain invisible 
(whether archived or not) when restored to disk. Use the 
SET FILE VISIBLE command to make invisible files visible. 
Until you do so, they will be inaccessible to most TOPS-20 
commands . 
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Hints 


Using Retrieved Archived Files 

As long as a retrieved archived file is visible, you can 
inspect it using the TYPE or PRINT command, or list its 
specifications using DIRECTORY-class commands. However, you 
cannot add to it or change it (e.g, by using APPEND or 
EDIT) . To make changes to a copy of a retrieved archived 
file, first use the COPY command to copy it to a new 
specification. If you wish, you can then request archival 
for this new file (using the ARCHIVE command) and delete the 
old one (using the DELETE command with the ARCHIVED 
subcommand) . You can return an (unchanged) on-line archived 
file to off-line status by using the DELETE command with the 
CONTENTS-ONLY subcommand, or withdraw archive status from 
the file (i.e., make it an ordinary disk file) by using the 
DISCARD command. 

Using Retrieved Non-archived Files 

As long as a retrieved non-archived file is visible, you can 
use TOPS-20 commands with it as with any other disk file. 
The only difference is that after any command that has 
changed the file (e.g, EDIT), the tape copy of the file is 
no longer valid. This means that you cannot give the DELETE 
command with the CONTENTS-ONLY subcommand to return the file 
to off-line status. 


Special Cases 


Implied Retrieval Requests 

If your system has enabled the "automatic retrieval-wait" 
feature (give the INFORMATION SYSTEM-STATUS command to find 
out whether it has) , and the SET RETRIEVAL-WAIT command is 
in effect for your job, any command that attempts to use an 
off-line file will create an automatic retrieval request for 
that file. Under these conditions, commands such as TYPE or 
COPY for which you specify off-line files will not be 
executed until those files are retrieved. Implied ' retr ieval 
requests are most useful in batch jobs. 


Related Commands 


ARCHIVE 

CANCEL RETRIEVE 


for requesting archival 
of specified files 

for canceling retrieval 
requests before they are 
filled 


259 



RETRIEVE (Cont.) 


DELETE (with CONTENTS-ONLY subcommand) 

for deleting the disk 

contents only of 

retrieved (i.e., on-line) 
files 

DIRECTORY (with OFFLINE subcommand) for listing the 

specifications of visible 
off-line files 

DIRECTORY (with OFFLINE and INVISIBLE subcommands) 

for listing the 

specifications of 

invisible off-line files 


DIRECTORY (with TIMES TAPE-WRITE 

DISCARD 

INFORMATION RETRIEVAL-REQUESTS 


subcommand ) 

for finding out the write 
date of the tape copy of 
files 

for giving up the tape 
copy of retrieved files 

for finding out the 
status of retrieval 
requests 


Effect on Memory and Terminal 


The RETRIEVE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Examples 


1. Retrieve an off-line file. 

B RETRIEUE BRCHIVE . TXT 
BRCHIUE . TXT ,1 [OK 3 
i 
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2. Attempt to use a file. Upon discovering that it is off-line, 
retrieve the file. When it has been restored to your 
directory, discard the tape copy of the file, and then have 
it printed on your terminal. 

B TYPE FILBRK . HLP 
?File is off-line: FILBRK. HLP. 1 
6 RETRIEVE FILBRK . HLP 
FILBRK .HLP. 1 [OK] 


6 DISCARD FILBRK . HLP 
FILBRK. HLP. 1 [OKI 
B TYPE FILBRK .HLP 
! TH I S IS JUST A TEXT FILE TESTER. 

B 

3. Get a listing of your archived files. Retrieve one that is 
off line, examine it, and return it to off-line status. 

6 DIRECT0RY > 

BB ARCHIUE 

B@ 


M ISC: < GOLDEN > 

ARCHE K .FIL. 1 
ARCHIVE . ALSO . 1 i OFFLINE 
.NOT, 1 > OFFL I NE 
.TOO. 1 ? OFFL I NE 
.ZOTH. 1 
ARTEST , OIL . 1 
BRCHIVE.TXT . 1 .OFFLINE 
DRCHIVE.TXT. 1 
ERCHIVE.TXT , 1 i OFFLINE 
FRCHIME.TXT . 1 .OFFLINE 
MAYBE . TXT . 1 
M00BE.TXT . 1 iOFFLINE 
TESTY. BBN. 1 .2 

Total of 14 files 
B RETRIEUE BRCjjlVE , TXT 
BRCHIUE.TXT, 1 [OKI 


♦ 

B TYPE BRCHIUE . TXT 
! A TEXT FILE TESTER 
B DELETE BRCHIVE . TXT > 
BB CONTENTS-ONLY 
SB 

MISC:<GOLDEN> BRCHIVE.TXT . 1 [OKI 
M I SC : < GOLDEN > [1 paJe freed] 

B 
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4. Get an inclusive listing of your off-line files, including 
the date the tape copy was written. Retrieve three of them, 
and check the requests in the retrieval queue. Cancel one of 
the requests. 

@ D I RECTORY > 

@@ 0FFL I ME 
@@ T I MES TAPE-UIRITE 
@@ 


M I S C : < G 0 L D E N > 

Tape- write 

ARCHIVE. ALSO. 1 ! OFFLINE B-Jun-79 07:59:08 
.NOT. I ; OFFLINE B-Jun-79 07:59:09 
DUMPER. MAC. 1 i OFFLINE 7- Mar-79 05:19:10 
PR0DUK . EXE . 4 i OFFLINE 7-Ma r-79 05:19:13 
SQUARE.EXE. 150FFLINE 7-Ma r-79 05 : 1 9 : 1 4 

Total of 5 files 
@ D I RECTORY , 

BB OFFLINE 
@@ INVISIBLE 
BB TIMES TAPE-HRITE 
@@ 

M ISC: < GOLDEN > 

Tape- write 

ARCHIVE. TOO. 1 i OFFLINE B-Jun-79 07:59:10 
BRCHIVE.TXT . 1 iOFFLINE 27-Jun-79 04:04:58 
ERCHIVE.TXT. 1 5 OFFLINE B-Jun-79 07:59:1 1 
FRCHIVE.TXT. 1 ! OFFL I NE 12-Jul-79 03:23:03 
M00BE.TXT , 1 i OFFL I NE 8-Jun-79 07:59: 12 

Total of 5 files 

B RETRIEVE PRQDUK.EXE > FRCHIVE.TXT > M00BE.TXT 
PRODUK.EXE. 4 C OK 3 
FRCHIVE.TXT. 1 [OKI 
M00BE.TXT. 1 [OKI 
e iNFQRMATION RETRIEVAL-REQUESTS 

Retrieval Queue: 


Name 

Res# 

Tape 1 

Tape 2 

User 

MOOBE 

507 

5329 

5520 

GOLDEN 

PRODUK 

50 5 

5538 

5583 

GOLDEN 

FOOBAR 

407 

5845 

5858 

TOMCZAK 

EE 1 55 

442 

8279 

5883 

WRIGHT 

BRCHIV 

504 

5543 

7138 

GOLDEN 

FRCHIV 

50 8 

7138 

7559 

GOLDEN 


There are 8 Jobs in the Queue (None in Progress) 

B CANCEL RETRIEVE 507 
Cl Job Canceled] 

@ 
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REWIND 


Function 


The REWIND command returns a magnetic tape to its load point 
(logical beginning, the beginning of the first file). 


Format 


@ REWIND (DEVICE) dev: /switch 
where 

dev: is the name of the tape set or magnetic tape drive 

that you want to rewind 

/switch is one of the following: 


/CURRENT-VOLUME-ONLY 

rewinds tape set to beginning 
of currently mounted volume 

/ENTIRE-VOLUME-SET 

rewinds tape set to beginning 

of first volume 

Default - ENTIRE-VOLUME-SET 

Note: these switches can be used only for 

devices of the form MTn : , not 
MTAn : . 


Restrictions 


REWIND with Open Files 

If you have given a CTRL/C to exit from a program that has 
opened a magnetic tape set and you then give the REWIND 
command for that tape set, the system will first ask if you 
want to close the associated file. You must do so _ for 
REWIND to succeed, but will probably be unable to continue 
the program from that point because the file will now be 
closed . 


Effect on Memory and Terminal 


The REWIND command does not affect memory and 
terminal at TOPS-20 command level. 


leaves your 
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Related Commands 


BACKSPACE 

for moving a magnetic tape backward a 
number of files or records 

specified 

DIRECTORY 

(when used with a magnetic tape device) for 
rewinding a tape set, printing a directory of its 
files, and again rewinding the tape set 

SKIP 

for moving a magnetic tape forward a 
number of files or records 

specified 

UNLOAD 

for rewinding a magnetic tape completely 
source reel 

onto the 


Examples 


1. Rewind your magnetic tape. 

B REW I ND DAY : 

0 

2. Mount a tape, and prepare to copy files onto it. (Use the 
REWIND command to be sure you are at the beginning.) After 
copying the files, rewind the tape and (using the COPY 
command) read the first one. Then give TOPS-20 commands to 
free the resources you have been using. 

B MQUNT TAPE DAY : 

[Mount Request DAY Queued > Resuest-ID 183] 

[Tape set D A Y t volume DAY in o u n ted] 

[DAY: defined as M T 0 : ] 

B MQUNT STRUCTURE SNARKj 
Structure S N A R K : mounted 
6 ACCESS 5NARK : 

B REMIND DAY: 

B CQPY SNARK’ :FIL-1 .TAP DAY: 

SNARK : F I L - 1 .TAP. 1 => MT0:FIL-1 [OK] 

B CQPY SNARK:FIL-2.TAP DAY: 

SNARK :FIL-2. TAP. 1 => MT0:FIL-2 [OK] 

B CQPY SNARK : FIL-3 . TAP DAY: 

SNARK : FIL-3 . TAP . 1 = > MTO: FIL-3 [OK] 

B REHIND DAY : 

B CQPY DAY: TTY: 

MTO : = > TTY : 

! THIS IS THE FIRST FILE. ! 

B DI5M0UNT TAPE DAY: 

[Tape dismounted > logical name DAY: deleted] 

B END-ACCESS SNARK : 

B DISMDUNT STRUCTURE SNARK: 

Structure SNARK: dismounted 
B 
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RUN 


Function 


The RUN command places in memory and starts an executable 
program. 


Format 


@RUN f ilespec/switch 
where 

filespec is the file specification of any executable program 

Default dev:<dir> - DSK : 

Default .typ - .EXE 

/switch is /USE- SECT I ON : n 

specifies the memory section (from 0 to 37 
octal) in which your program is to run. You 
can use this switch only if your program can 
be contained in one section. 


Characteristics 


Efficiency of RUN 

The RUN command does the work of the pair of commands GET 
and START. It is a faster and less expensive means of 
executing programs than EXECUTE, or than LOAD and START. 
Therefore you should store frequently-run programs in .EXE 
files and run them with this command. 


Effect on Memory and Terminal 


The RUN command terminates the current process and clears its 
memory, places in memory and starts the specified program, and 
leaves your terminal at command level in the program (if any), or 
at TOPS-20 command level. 


Related Commands 


EXECUTE for running source or object programs 

GET for placing an executable program in memory 

R for running executable programs stored on SYS: 

SAVE for saving a program in executable (.EXE) format 

START for starting the program currently in memory 
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Examples 


1. Run one of your executable programs. 

@ RUN TESTF1 , EXE 

THIS IS A TEST. 

END OF EXECUTION 

CPU TIME: 0 . 04 ELAPSED TIME: 0.G3 

EXIT 

@ 

2. Mount a structure and access a user's directory on 
structure. Run one of his programs. 

B MOUNT STRUCTURE SNARK : 

Structure SNARK: mounted 
B ACCESS SNARK : < E L D R I D G E > 

P a s s w o r d : 

@RUN SNARK :<ELDRIDGE>FT .EXE 


NEXT NUMBER : 


the 


266 



SAVE 


Function 


The SAVE command stores a copy of memory in an executable file. 


Format 

@ SAVE (ON FILE) filespec (PAGES FROM) loci (TO) loc2, loc3 loc4, ... 

where 

filespec is the file specification under which you want to 
store the program 

Default filespec - program name.EXE 

loci loc2, are pairs of octal numbers or symbolic expressions 
loc3 loc4, that specify the span(s) of memory pages you want to 
. . . save 

Default loci loc2 - all assigned pages of 
memory from 0 to the highest 
page number of the highest 
existing section 

Output 


Status of Files 

If you use recognition of the file specification, the system 
prints !01d Generation!, !New Generation!, or !New File!, to 
indicate its status on disk, or !OK! if saved on a non-disk 
device . 


Hints 


Saving Programs Before Running Them 

When you load a source or object program using the LOAD 
command, save it using SAVE before running it. Then you can 
run it in the future using RUN, without first loading it 
using a LOAD-class command. This is also true if you save 
the program after running it, but it will then be in a 
post-run state. 

More Information 

For more information about saved files, see the TQPS-20 
Monitor Calls Reference Manual. 


Effect on Memory and Terminal 


The SAVE command does not affect memory and leaves your terminal 
at TOPS-20 command level. 
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Related Commands 


GET for putting a saved file into memory 

LOAD for putting a source or object file into memory 

RUN for running a saved program 

START for starting the program in memory 


Examples 


1. Save the program currently in memory. 

B SAUE 

TESTF1 . EXE.S Saved 

@ 

2. Mount a magnetic tape in write-enabled mode. Use the GET 

command to put an executable program into memory, then save 

it (specifying a new filename) on tape and on disk. Finally, 

start the program, which is still in memory. 

@ M0UNT TAPE LAT : / WRITE-ENABLED 

[Mount Request LAT: Queued) Request- ID 4 1 5 ] 

[Tape set LAT . volume LAT mounted! 

[LAT: defined as MT2 : ! 

@ GET TESTF1 
8 SAUE LAT: TAP. EXE 
MT2 : TAP . EXE Saved 
@ S A 0 E 

TAP. EXE. 1 Saved 
@ 5T ART 

THIS IS A TEST. 

END OF EXECUTION 

CPU TIME: 0.04 ELAPSED TIME: 0.17 
EXIT 
@ 
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SET 


Function 


The SET command establishes your choice of many available options 
for your terminal session (job) or directory. 


Format 


@SET argument(s) setting(s) 
where 

argument is a keyword, chosen from the list below, indicating 

your choice of SET command options 

setting is a word or number, required to complete the 

meaning of most SET commands 


Summary of SET Command Arguments (defaults in boldface) 


ACCOUNT account remark 

ADDFESS-BREAK octal or symbolic memory address, 
@ @AFTER n Default n - 1 
@@ALL 
@ 0EXECUTE 
@ @NONE 
@@READ 
@ 0WRITE 

ALERT date/time message 

AUTOMATIC 


CARD-READER-INPUT-SET name of input set n 
CONTROL-C-CAPABILITY 
/ 

CARDS /switch (es) 

COMPILE-SWITCHES file type /switch (es) 
PAPER-TAPE /switch (es) 

DEFAULT | PLOT /switch(es) 

PRINT /switch(es) 

SUBMIT /switch (es) 
f ALLOW 

TAKE } DISALLOW 
, ECHO 
'NO ECHO 

ACCOUNT-DEFAULT dev : <d i rector y> account 
password 


DIRECTORY | ARCHIVE-ONLINE- EX PI RED- FILES 

FILE-PROTECTION-DEFAULT dev: <directory> octal code 
password 

Default code - 777700 
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DIRECTORY <v 
(Cont. ) 


GENERATION-RETENTION-COUNT-DEFAULT dev: <directory> n 
password 

Default n - 1 


NO ARCHIVE-ONLINE-EXPIRED-FILES 

OFFLINE-EXPIRATION-DEFAULT d ev : <d i r ec tor y>d a te or +n 
Default n - 90 

ONLINE-EXPIRATION-DEFAULT dev : <d i rector y>d a te or +n 
Default n - 60 
PASSWORD dev: <directory> 
old password 
new password 
new password 


PROTECTION dev : <d i r ectory> octal protection code 
password 

Default code - 777700 


ENTRY-VECTOR (octal or symbolic ) octal or symbolic length 
(memory location / between 1 and 777 
Default length - 1 

( ACCOUNT filespecs account 
EXPIRED filespecs 

GENERATION-RETENTION-COUNT filespecs n Default n - 1 
INVISIBLE 

NO PROHIBIT filespecs 
RESIST filespecs 

OFFLINE-EXPIRATION filespecs date or +n 
ONLINE-EXPIRATION filespecs date or +n 
PROHIBIT filespecs 

PROTECTION filespecs octal protection code 
Default code - 777700 
RESIST filespecs 
\ VISIBLE 


LATE-CLEAR-TYPEAHEAD 

LOCATION node name:: Default node name - your host node 
MAIL-WATCH user name 


' ADDRESS-BREAK 
ALERT 
AUTOMATIC 

CONTROL-C-CAPABILITY 


NO 


/ CARDS 

1 COMPILE-SWITCHES 
1 PAPER-TAPE 
DEFAULT / PLOT 
) PRINT 
SUBMIT 
TAKE 


I 


file type or * 
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NO 

( Cont . ) 


LATE-CLEAR-TYPEAHEAD 

MAIL-WATCH user name 
RETRIEVAL-WAIT 
TIME-LIMIT 

{ <RET> 

FILE-OPENINGS 
( /ALL 
JSYS \ name 

( number 

UUO-S IMULATION 


PAGE-ACCESS octal page numbers 


COPY-ON-WRITE 

EXECUTE 

/ COPY-ON- WRITE 
NOlWRITE 

NONEXISTENT 

READ 

WRITE 


RETRIEVAL-WAIT 


SESSION-REMARK remark of up to 39 characters 

( IMMEDIATE 

SPOOLED-OUTPUT I DEFERRED 


DENSITY 


TAPE FORMAT 


PARITY 


1 200 
556 
800 
1600 
6250 

SYSTEM-DEFAULT 

( ANSI-ASCII 
) CORE-DUMP 
) INDUSTRY-COMPATIBLE 
I SYSTEM-DEFAULT 

I EVEN 
( ODD 


RECORD-LENGTH n bytes Default n - 512 


TIME-LIMIT n 


FILE-OPENINGS 
( /ALL 
JSYS < name 

( number 
<RET> 

TRAP< NOl FILE-OPENINGS 
( /ALL 
| JSYS < name 

( number 
^PROCEED 
PROCEED 


TYPEOUT MODE ( NUMERIC 
| SYMBOLIC 

UUO SIMULATION 
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SET Command Arguments 
ACCOUNT account remark 

begins charging the specified account 
for the remainder of your current 
terminal session or until you use the 
command again. You must supply an 
alphanumeric account name of 39 or fewer 
characters valid for your user name. 
Then you can type an optional session 
remark, also of 39 or fewer characters, 
to be inserted in system accounting data 
for your current terminal session. 
Check your current account and session 
remark with INFORMATION JOB-STATUS. 

| ADDRESS-BREAK octal or symbolic memory location, 

causes the program in memory to be 
suspended and a message to be printed on 
@@AFTER n your terminal when the memory location 

@@ALL you specify is referenced for the 

@@EXECUTE indicated operation - execute, read, 

@@NONE write, or any of these (ALL). With the 

@@READ AFTER subcommand you determine how many 

@@WRITE times it must be referenced before the 

address break occurs; with NONE you 
cancel address breaks for the specified 
location, just as with the SET NO 
ADDRESS-BREAK command. Each SET 

ADDRESS-BREAK command cancels any 
previous address break. Check your 
current address break with INFORMATION 
ADDRESS-BREAK. 

Default subcommands - ALL, and 

AFTER 1 

causes the system to buzz your terminal 
and type a line at the specified date 
and time. This line contains the time of 
day and your message. If the SET 
AUTOMATIC command is in effect, this 
message is sent no matter what you are 
doing at your terminal. Otherwise, you 
are alerted only when your terminal is 
about to type a TOPS-20 prompt ($ or @). 
Alert settings are erased when you log 
out. Therefore, you should enter this 
command in your COMAND.CMD file if you 
want to be alerted in the distant future 
or on a regular basis. Check the setting 
of this command with INFORMATION ALERTS. 
Refer to Example 8. 

AUTOMATIC allows you to be notified by the system 

(as a result of a SET ALERT or SET 
MAIL-WATCH command) whether or not your 
job is at TOPS-20 command level. Every 
five minutes, the system checks to see 
if you should be notified. It is 
recommended that you enter this command 
in the COMAND.CMD file to ensure 
coverage from the time you log in. 


{ date and time) 
time / 

+hh:mm /message 

day of week l 
TODAY ' 
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SET Command Arguments (Cont.) 


CARD-READER-INPUT-SET name of input set n 

is used by the batch system to associate 
the indicated set of punch cards, 
beginning with deck n, with system 
device CDR: 

CONTROL-C-CAPABILITY allows any program executed at the 

current command level to handle CTRL/C 
interrupts itself. You cannot use this 
command in a batch job. Check the 
current setting with INFORMATION 
PROGRAM-STATUS. 

! Default 

CARDS /switch (es) 

COMPILE-SWITCHES file type /switch (es) 

PAPER-TAPE /switch (es) 

PLOT /switch (es) 

PRINT /switch (es) 

SUBMIT /switch(es) 

S ALLOW 
DISALLOW 
ECHO 

NO ECHO sets up, as default global arguments to 

the command selected (CARDS refers to 
the PUNCH CARDS command, COMPILE- 
SWITCHES to all the LOAD-class commands, 
and PAPER-TAPE to the PUNCH PAPER TAPE 
command) , the arguments you specify. 
These arguments are switches, except for 
SET DEFAULT TAKE, which allows arguments 
ALLOW/DISALLOW (errors during the 
execution of a command file) , ECHO, and 
NO ECHO. You can specify any switch 
valid for the given command, preceding 
each switch with a slash (/) . For 
COMPILE-SWITCHES you must precede the 
switches with the file type (excluding 
the period (.)) to which you want the 
switches to apply; then the switches 
behave as if typed immediately after 
each file of this type. Check current 
settings with INFORMATION DEFAULTS. 

DIRECTORY ACCOUNT-DEFAULT dev : <d i r ec to r y> default account 
PASSWORD: pas sword 

sets the account of 39 or fewer 
characters to charge for your terminal 
session whenever you log in to this 
directory without specifying an account. 
Check with INFORMATION DIRECTORY. 

DIRECTORY ARCH IVE-ONLINE-EXPIRED-F I LES dev : <d i r ectory> 

causes on-line files that have expired 
to be automatically archived. Check 
with INFORMATION DIRECTORY. 
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SET Command Arguments (Cont.) 


DIRECTORY FILE-PROTECTION-DEFAULT dev : <d irectory> octal code 
PASSWORD : pas sword 

sets a default protection code governing 
access to files subsequently created in 
the directory. See description of FILE 
PROTECTION argument for a list of valid 
protection codes. Check with 

INFORMATION DIRECTORY. 

Default code - 777700 

DIRECTORY GENERATION-RETENTION-COUNT-DEFAULT d ev : <d i r ec to ry> n 
PASSWORD : password 

prescribes for the directory a default 
value for the number of generations of 
subsequently-created files to save. 
Check with INFORMATION DIRECTORY. 

Default n - 1 

DIRECTORY NO ARCH IVE-ONLINE-EXPIRED-FI LES 

prevents on-line files that have expired 
from being automatically archived 

Default 

DIRECTORY OFFLINE-EXPIRATION-DEFAULT dev: <directory> date or +n 

sets the tape expiration date for files 
that are to go off line because of 
archiving or migration. If you specify 
"+n", the expiration date is n days from 
the date the files were moved off line. 

Default n - 90 

DIRECTORY ONLINE-EXPIRATION-DEFAULT dev : <d i r ect.ory> date or +n 

sets the disk expiration date for files 
that are to be created in the directory. 
If you specify "+n", the expiration date 
is n days from the creation date. 

Default n - 60 

DIRECTORY PASSWORD dev : <d i r ec to r y > 

OLD PASSWORD:old password 
NEW PASSWORD:new password 
RETYPE NEW PASSWORD:new password 

allows you to change the password of the 
directory named. Check with INFORMATION 
DIRECTORY. 

DIRECTORY PROTECTION de v : <d i r ec tory > octal protection code 
PASSWORD : pas sword 

establishes for the directory a 
protection code constructed (by 
addition) from the values shown below. 
Check with INFORMATION DIRECTORY. 
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SET Command Arguments (Cont.) 


77 full access to the directory 

40 access to files in the directory (including expunging 

individual files) , consistent with the file protection 
of the files 

10 connect to the directory without giving a password, 

undelete files, expunge the entire directory, and 
change times, dates and accounting information for 
files. All other access is governed by the file 
protection of each file. 

04 create files in the directory 

00 no access to the directory 

Default code - 777700 

See the TQPS-20 User's Guide for more information about 

protection codes. 


ENTRY-VECTOR (octal or symbolic) octal or symbolic length 
( memory location ) from 1 to 777 

lets you change the entry vector of the 
program in memory. Check the current 
setting with INFORMATION MEMORY-USAGE. 

Default length - 1 

FILE ACCOUNT filespecs account 

specifies the account to charge for 
storage of the files named. Check with 
FDIRECTORY . 

FILE EXPIRED filespecs 

establishes today as the expiration date 
for the specified on-line files. Check 
with DIRECTORY. 

FILE GENERATION-RETENTION-COUNT filespecs n 

tells the system how many generations of 
the specified files to save. Check with 
FDIRECTORY. 

Default n - 1 


FILE INVISIBLE filespecs 

makes the specified file inaccessible to 
most programs and TOPS-20 commands 

FILE NO PROHIBIT filespecs 

allows the system to migrate the 
specified file to off-line storage if 
disk space becomes low. For privileged 
users only. 

Default 


FILE NO RESIST filespecs 

cancels the effect of the SET FILE 
RESIST command. This switch allows the 
system to move the specified files to 
off-line storage without hesitating. 
Default 
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SET Command Arguments (Cont.) 


FILE OFFLINE-EXPIRATION 


filespecs date or +n 
specifies when the 
off-line file can 
off-line storage. If 
the expiration date 
date it was moved off 


contents of an 
be expunged from 
you specify "+n" , 
is n days from the 
line . 


FILE ONLINE-EXPIRATION filespecs date or +n 

establishes the date on which the disk 
contents of the specified files will 
expire. If you specify "+n", the 
expiration date is n days from the 
current date. Check with DIRECTORY. 


FILE PROHIBIT filespecs 

tells the system never to migrate the 
specified file to off-line storage. For 
privileged users only. (Nonpr ivileged 
users should refer to the description of 
the SET FILE RESIST command. See also 
Hints - Alternative to SET FILE PROHIBIT 
for Non-pr ivileged Users, below.) 

FILE PROTECTION filespecs octal protection code 

sets, for the specified files, a 
protection code constructed (by 
addition) from the octal values shown 
below. Check with FDIRECTORY . 

77 full access to the file 

40 read the file 

20 write and delete the file 

10 execute the program contained in the file 

04 append to the file 

02 list the file specification using DIRECTORY-CLASS 

commands 

00 no access to the file 

Default code - 777700 

See the TQPS-20 User's Guide for more information about 
protection codes. 

FILE RESIST filespecs 

offers nonpr ivileged users limited 
protection against migration. The 
specified files will be forced offline 
only when absolutely necessary. Check 
with DIRECTORY. 

FILE VISIBLE filespecs 

makes the specified file accessible to 
all programs and TOPS-20 commands 
Default 
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LATE-CLEAR-TYPEAHEAD 


LOCATION node name:: 


MAIL-WATCH user name 


NO ALERT date/time 


NO AUTOMATIC 


instructs the system to disregard 
terminal input made after a line 


causes an error and before the 
prompt. Check the setting for 
current level of TOPS-20 
INFORMATION COMMAND-LEVEL. 


all 

that 

next 

your 

with 


sets the DECnet network node at which 
your job is considered to be running. 
Your PLEASE requests and MOUNT command 
requests are sent to this node, as well 
as any line printer output not directed 
elsewhere (e.g., by the 
/DESTINATION-NODE switch) . You must 
terminate the node name with two colons 
(::). Check available nodes with 
INFORMATION DECNET, and check your 
current setting (if different from your 
host node (log-in node)) with 
INFORMATION JOB-STATUS. 

Default node name - your host node 

checks the MAIL file for the specified 
user immediately and every five minutes 
thereafter whenever your terminal is 
about to type a TOPS-20 prompt (@ or $) , 
and sends a message notifying you that 
the user has new mail if this file 
contains unread mail. If the SET 
AUTOMATIC command is in effect, this 
message is sent no matter what you are 
doing at your terminal. 

Default user name - your user name 


removes settings that were established 
with the SET ALERT command. You can 
specify date and time in the same 
formats as with SET ALERT. 
Additionally, you can enter BEFORE or 
AFTER the date and time to indicate a 
time period in which alerts are to be 
suppressed. If you specify no date or 
time argument, all alert settings are 
erased. This command takes effect when 
you log out. 

Default 


causes you to be alerted by the system 
(as a result of a SET ALERT or SET 
MAIL-WATCH command) only when your 
terminal is about to type a TOPS-20 
prompt ( @ or $ ) . 

Default 
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SET Command Arguments (Cont.) 


NO CONTROL-C-CAPABILITY 

removes the ability of programs at the 
current level of TOPS-20 to prevent your 
terminal from returning to the TOPS-20 
command processor whenever you type a 
CTRL/C; i.e., ensures that CTRL/C will 
return you to TOPS-20. Check the 
setting for your current level of 
TOPS-20 with INFORMATION PROGRAM-STATUS. 

I CARDS 

COMPILE-SWITCHES file type 

PAPER-TAPE 

PLOT 

PRINT 

SUBMIT 

nullifies all default arguments 
(established with a previous SET DEFAULT 
command) for the indicated command 

NO LATE-CLEAR-TYPEAHEAD 

instructs the system to accept terminal 
input made after an error message is 
sent to your terminal and before the 
next prompt. Check the setting for your 
current level of TOPS-20 with 
INFORMATION COMMAND-LEVEL. 

Default 

NO MAIL-WATCH user disables periodic checking of the MAIL 

file associated with the specified user, 
although you see the notice, YOU HAVE A 
MESSAGE, at log-in time; and you see 
[YOU HAVE A MESSAGE FROM user] whenever 
someone sends you mail, unless you have 
given the REFUSE SYSTEM-MESSAGES or 
REFUSE LINKS command. You can always 
check the status of your MAIL file at 
any time by giving the INFORMATION MAIL 
command . 

Default 

NO RETRIEVAL-WAIT tells the system to send an error 

message if your job attempts to use 
off-line files. 

Default 

NO TIME-LIMIT removes any time limit set by a previous 

SET TIME-LIMIT command. You cannot use 
this command in a batch job. 
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SET Command Arguments (Cont.) 

NO TRAP prevents any trapping that would have 

occurred as the result of a SET TRAP 
command . 

Default 

NO TRAP FILE-OPENINGS nullifies the effects of the SET TRAP 

FILE-OPENINGS command, disabling the 
TOPS-20 feature that causes you to be 
notified when a program tries to open a 
file. 

Default 


nullifies the effects of the SET TRAP 
JSYS command, disabling the TOPS-20 
feature that causes traps to occur when 
a JSYS is executed. 

Default 

NO UUO-S IMULATION disables the feature of the TOPS-20 

monitor that makes it possible to use 
programs originally written for the 
TOPS-IO operating system. Check the 
current setting with INFORMATION 
PROGRAM-STATUS. 

PAGE-ACCESS range of octal page numbers type of access 

COPY-ON-WRITE 

provides programs with private copies of 
the specified pages (13:17, 21 specifies 
pages 13 through 17 and page 21, 6 pages 
in all) of current memory whenever they 
try to change (write to) them 

EXECUTE allows programs accessing these pages to 
execute the instructions they may 
contain 

( COPY-ON-WRITE 

NO ( WRITE prevents programs from performing the 
indicated operation on the specified 
pages 

NONEXISTENT 

removes the indicated pages from memory 

READ permits programs to examine the 

indicated pages of memory 

WRITE permits programs to change as well as 

examine the indicated pages 


I /ALL 

NO TRAP JSYS \ name 

l number 
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SET Command Arguments (Cont.) 


Check the status of current memory pages with 
INFORMATION MEMORY-USAGE. 

RETRIEVAL-WAIT tells the system that your job is 

willing to wait for retrieval of 
off-line files. Retrieval is then 
requested implicitly whenever you or a 
program you run attempts to access 
off-line files. Use INFORMATION 

SYSTEM-STATUS to be sure that automatic 
retrieval waits are enabled for the 
system before giving this command. 

SESSION-REMARK remark lets you insert a note or reminder of up 

to 39 characters into system accounting 
data. Check with INFORMATION JOB- 
STATUS. 

( IMMEDIATE 

SPOOLED-OUTPUT I DEFERRED directs the system either to begin 

processing your spooled output requests 
(e.g., those made using the COPY or CREF 
command) as soon as you make them, or to 
defer them until log-out. Check with 
INFORMATION SPOOLED-OUTPUT-ACTION . 

Default - IMMEDIATE 

1 200 
556 
800 
1600 
6250 

SYSTEM-DEFAULT 

instructs the system to read and write 
magnetic tapes for your job at the 
indicated density (in bits per inch). 
SYSTEM-DEFAULT, one of these values 
(usually 1600) , is established by your 
system manager. The value set by this 
command can be superseded by commands 
within a program. Check with 

INFORMATION TAPE-PARAMETERS. 

Default - SYSTEM-DEFAULT 
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I ANSI-ASCII 
CORE-DUMP 
HIGH-DENSITY 
INDUSTRY-COMPATIBLE 
SIXBIT 

SYSTEM-DEFAULT 

advises the system that the format to 
use in processing tapes is either 
ANSI-ASCII, which stores each word of 
data as five 7-bit bytes in five frames 
of a 9-track type; or CORE-DUMP, which 
stores each word of data as a single 
36-bit byte in five frames of a 9-track 
tape, partially using the fifth frame; 
or HIGH-DENSITY, which stores each two 
words of data as nine 8-bit bytes in 
nine frames of a 9-track tape; or 
INDUSTRY-COMPATIBLE, which stores each 
word of data as four 8-bit bytes in four 
frames of a 9-track tape; or SIXBIT, 
which stores each word of data as six 
6-bit bytes in six frames of a 7-track 
tape. SYSTEM-DEFAULT, one of these 
(usually CORE-DUMP) , is chosen by your 
system manager. See also Restrictions - 
Using SET TAPE Commands, in the MOUNT 
command description in this manual. See 
the TOPS-20 Monitor Calls Reference 
Manual for more information about 
hardware data modes for magnetic tapes. 
Check with INFORMATION TAPE-PARAMETERS. 
Default - SYSTEM-DEFAULT 

I EVEN 

TAPE PARITY! ODD tells the system which parity to assume 

when verifying the accuracy of tape 
records. Check with INFORMATION 
TAPE-PARAMETERS . 

Default - ODD 

TAPE RECORD-LENGTH n sets the size, in bytes, for each 

physical record on a tape. Check with 
INFORMATION TAPE-PARAMETERS. 

Default n - 512 


TIME-LIMIT n tells the system to stop any program or 

terminal printout when the given amount 
of additional CPU time (in seconds) has 
been used, and to inform you with a 
fatal error message. This command is 
used by the batch system to limit the 
runtime of batch jobs. 
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SET Command Arguments (Cont.) 

TRAP FILE-OPENINGS sends a message to your terminal when 

any program attempts to open a file. 
Check with INFORMATION PROGRAM-STATUS. 
Refer to Example 5. 


causes trapping to occur for all or for 
the specified JSYS. You can specify a 
JSYS by its name or octal value. Check 
with INFORMATION PROGRAM-STATUS. Refer 
to Example 6. 


NOTE 

The SET TRAP command is 
ineffective for execute-only 
programs (those with a 
protection code of 10) . 
Attempts to run such programs 
after a SET TRAP command has 
been specified will result in 
error messages. 


TRAP NO same as SET NO TRAP. 

TRAP NO FILE-OPENINGS same as SET NO TRAP FILE-OPENINGS. 

{ /ALL 
name 

number same as SET NO TRAP JSYS. 

TRAP NO PROCEED directs the system to terminate the 

program after a trap has occurred as a 
result of a SET TRAP command. Check 
with INFORMATION PROGRAM-STATUS. Refer 
to Example 7. 

TRAP PROCEED directs the system to continue a program 

after a trap has occurred as a result of 

a SET TRAP command. Check with 
INFORMATION PROGRAM-STATUS. 

Default 

TYPEOUT MODE f NUMERIC 

(SYMBOLIC establishes the mode in which memory 
addresses and contents are to be typed 
on your terminal in response, for 
example, to a CTRL/T or a command such 
as EXAMINE or INFORMATION. Check with 
INFORMATION PROGRAM-STATUS. 

Default - NUMERIC 


( /ALL 
TRAP JSYS ^ name 

( number 
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SET Command Arguments (Cont.) 


UUO-S IMULATION allows the system to execute programs 

originally written for the TOPS-IO 
operating system, by calling the TOPS-IO 
compatibility package, PA1050.EXE. 
Check the current setting with 
INFORMATION PROGRAM-STATUS. 

Default 


Characteristics 


Affect Only Current Terminal Session 

The SET command, except for SET DIRECTORY and SET FILE, 
applies to the current terminal session only, and in most 
cases only to the current level of TOPS-20 in that session. 
Therefore put SET DEFAULT, SET CONTROL-C-C APAB I LITY , and 
other SET commands into a COMAND.CMD file in your log-in 
directory if you want them to be in effect every time you 
log in or give the PUSH command. 


Hints 


Using SET PAGE-ACCESS 

A SET PAGE-ACCESS command can take several arguments on the 
same line, with cumulative effect; contradictions are 
resolved in favor of the last item given. So SET 
PAGE-ACCESS 6 EXECUTE NO COPY-ON-WRITE NO WRITE allows a 
user to execute page 6 but not to change it; SET 

PAGE-ACCESS 7 NO WRITE WRITE allows changes to page 7. 

To Make Modifiable Copies of Write-protected Programs 


Because the SAVE command preserves the write protection of 
files, you should use the SET PAGE ACCESS WRITE or SET 
PAGE-ACCESS COPY-ON-WRITE command before giving SAVE if you 
want to save a modifiable copy of a program. 

Using SET TIME-LIMIT 

Although the SET TIME-LIMIT command is ordinarily used by 
the batch system to limit the runtime of jobs, you can 
employ it as a timesharing user to give you a fatal error 
message when the specified amount of CPU time has been 
spent. To find out how much of this time you have left, 
give the SYSTAT . LIMIT and INFORMATION PROGRAM-STATUS 
commands. The difference between the SYSTAT . LIMIT time 
and the "Used" time reported by INFORMATION PROGRAM-STATUS 
tells you the approximate time remaining. 
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SET Commands Useful for Debugging Programs 
SET ADDRESS-BREAK 

SET ADDRESS-BREAK shows you how often and for what 
purpose a memory address is referenced. When an 
address break occurs, a message will show the memory 
location at which execution of your program will 
resume . 

SET NO CONTROL-C-CAPABILITY , SET UUO-S IMULATION , SET 

PAGE-ACCESS 

If you are debugging a program, use the SET NO 
CONTROL-C-CAPABI LITY command to ensure that you can use 
CTRL/C to leave the program. Test a program that traps 
CTRL/Cs by having it trap, say, CTRL/As instead during 
debugging. Also, setting NO CONTROL-C-CAPABILITY , NO 
UUO-S IMULATION , or PAGE-ACCESS NO WRITE NO 
COPY-ON-WRITE will show you what part of the program 
(if any) is attempting to use these features. 

Alternative to SET FILE PROHIBIT for Non-pr ivileged Users 

Even if you do not have sufficient privileges to use the SET 
FILE PROHIBIT command, you can still do something to delay 
the removal of important files to off-line storage. Create 
a file named MIGRATION . ORDER in each directory for which you 
wish to control migration. The contents of this file should 
be the specifications of files that you want to be migrated 
first, when migration is performed. You may use wildcard 
characters (* and %) to specify more than one file. To 
protect source programs, for example, you could specify that 
executable programs and binary files be migrated first, by 
listing "*.EXE, * . REL" in MIGRATION . ORDER . To protect 

edited files, you could list M *.Q*" (this ensures that 
unedited back-up files produced by the EDIT program be 
migrated before the edited versions). Any files not listed 
in MIGRATION. ORDER will be protected from migration until 
all listed files have been migrated. Remember that, even 
without being listed in MIGRATION. ORDER, files are not 
usually migrated to off-line storage if they have been used 
or changed within a period of time specified by your system 
manager . 

The SET FILE RESIST command also offers limited protection 
against involuntary migration. 

Restrictions 

Using SET Commands in Batch Jobs 

Put SET commands into a BATCH.CMD file in your log-in 
directory if you want them to apply to the first (highest) 
level of TOPS-20 in batch jobs you submit; put them into 
COMAND.CMD in your log-in directory if you want them to 
apply to all levels of TOPS-20 in those jobs. Remember, 
though, that you must not give SET CONTROL-C-CAPABILITY, SET 
NO TIME-LIMIT, or SET TIME-LIMIT (or the ATTACH command) 
within any batch job. 
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Using SET DIRECTORY Commands 

You will be able to use the SET DIRECTORY commands only if 
your system is instructed at system start-up time to allow 
them. Otherwise, the system will send you error messages in 
response to SET DIRECTORY commands. 


Effect on Memory and Terminal 

The SET command does not affect memory and leaves your terminal 
at TOPS-20 command level. 


Examples 

1. Set the LATE-CLEAR-TYPEAHEAD parameter for your job. 

B SET LATE-CLEAR-TYPEAHEAD 
@ 

2. Find out the placement of your program in memory; set an 
address break to occur at location 2412 when the instruction 
it contains has been executed six times. Then give the 
INFORMATION ADDRESS-BREAK command to see the location and 
operation for which the current address break has been set. 

@ I NFORMAT I ON MEMORY-USAGE 

5 . pases i Entry vector loc 400010 len 254 0 0 0 

0-3 Private R t W , E 

400 Private R > W , E 

B SET ADDRESS-BREAK 2412 > 

@@AFTER_G 

SS EXECUTE 

BB 

ii INFORMATION ft D D RE S S - B R E A K 
Address break at 2412 on execute. 

@ 


3. Set defaults for PRINT command switches, then print a file 
immediately by explicitly supplying an /AFTER switch with an 
early hour as argument. 

B SET DEFAULT PRINT /LONER CASE/AFTER; 17:00 
S PRINT / A F T E R : 0 : 0 4-UPED.TXT 

[Job 4 - U P E D Queued t Resuest-ID 3 4 G , Limit 200] 

B I NFORMAT ION 0 U T PUT - RE Q UE5 T5 /USER 

Printer Queue: 

Job Name Res# Limit User 


* 4-UPED 34G 200 LATTA OnUnitsO 

Started at 16:11:11 , printed 0 of 200 pa Ses 
There is 1 Job in the Queue (1 in Progress) 

B 
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4. Put an executable program into memory and set the page access 
of its first page to NO COPY-ON-WRITE; try to deposit a 
value (32) in memory location 500 of the page (this fails). 
Then set its page access to COPY-ON-WRITE and try once more, 
succeeding this time. Give the INFORMATION MEMORY-USAGE 
command again. Notice that you now have your own copy of the 
page in memory; it is no longer mapped from the file 
TESTF1.EXE in your connected directory. 

B GET TESTF1 

B I NFQRMflT I ON MEMORY-USAGE 

1 i paSes i Entry vector 1 o c 145 len 254000 

0 TESTF1 . EXE .31 R » CW . E 

B SET PflGE-ftCCESS 0 NO C □ P Y - D N - N R I T E 
B DEPQSIT 500 32 
? C a n ' t write that paie 
Q SET PAGE -ACCESS 0 CQPY-QN-HRITE 
B DEPQSIT 500 32 
[Shared] 

B INFQRMflTION MEMORY -USAGE 
1 . p a 3 e s t Entry vector 1 o c 145 1 e n 254000 
0 Private R i W t E 

B 


5. Learn what files are opened when you edit a file. 

@ SET TRAP FILE-OPENINGS 
B EDIT LOGIN . CMP 

[ForK EDIT open in 3 SWITCH. INI. 3 for reading] 

[ForK EDIT opening LOGIN. CMD. 33 for reading] 

Edit : LOGIN. CMD. 33 

[ForK EDIT opening EDIT-BUFFER. OUT. 100042 for writing] 
* EU 

[ForK EDIT opening EDIT-BUFFER. OUT. 100042 for reading] 
[ForK EDIT opening LOGIN. CMD.34 for writing] 

[LOGIN. CMD. 34] 

B 
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6. Cause a trap to occur whenever the GTFDB JSYS is executed. 
Then edit a file. The EDIT command invokes the GTFDB JSYS 
and causes a line to type out in the following format: 

[fork "trap" <location>/< jsys name> "Ac's 1-4:" <ac contents>] 

Note that the location is in symbolic form if you so 
specified in the SET TYPEOUT MODE command. 

B SET TRAP JSYS GTFDB 
B ED I T LOGIN . CMP 

[EDIT trap 3515/ GTFDB Ac's 1 -4 : 1 1 \ 1 000004 \ 2032 1 \ A2A 1 53000000 ] 
[EDIT trap 35E2/ GTFDB Ac 's 1-4: 1 1 \20000 1 1 \4\424 1 53000000 3 
Edit: LDGIN.CMD. 42 
* EU 

[ LOG I N . CMD . 43 ] 

S 

7. Specify that program execution is to halt whenever a GTFDB 
JSYS causes a trap. Then edit a file. The EDIT command 
invokes the GTFDB JSYS, causing a trap to occur, which causes 
the EDIT process to immediately halt. 

B SET TRAP NO PROCEED 
B SET TRAP JSYS GTFDB 
B EDIT LOGIN . CMP 

[EDIT trap 3515/ GTFDB Ac's 1-4: 1 0 \ 1 000004 \2032 1 \ 424 1 53000000 ] 

S 

8. Arrange for the system to remind you of a future obligation. 
Then verify that you will be reminded. 

B SET ALERT (AT TIME) MONDAY 1 1:00: 0 0 Turn in last week's time card b y n o o n 
B SET AUTOMATIC 

B INFQRMATIQN (ABOUT) ALERTS (PENDING) 

Next alert at 8 - J u n - 8 2 18:55:00 - Almost time to so home! ! 

Other alerts set for: 

ll-Jun-82 08:55:00 - Project m e e t i n S at 8:00:00 
1 4 - J u n - 8 2 1 1:0 0 : 0 0 - Turn in last week's time card b v n o o n 


Alerts are automatic 
B 
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SKIP 


Function 


The SKIP command moves a magnetic tape 
specified number of files or records, or 
the tape set. 


set forward over a 
to the logical end of 


Format 


@SKIP (DEVICE) dev: n units 


where 
dev : 


n 


units 


is the name of the tape set or magnetic tape drive that 
you want to move forward 

is the number of files or records over which you want 
to skip 

is either FILES or RECORDS, where records are sections 
of a file; or LEOT, to skip to the logical end of the 
tape set, which is the next point on the tape set 
having two adjacent EOF (end-of-f ile) marks. 

Default units - FILES 


Restrictions 


SKIP With Open Files 

If you have given a CTRL/C to exit from a program that has 
opened a file in a magnetic tape set and you then give the 
SKIP command for that tape set, the system will first ask if 
you want to close the associated file. You must do so for 
SKIP to succeed, but you will probably be unable to continue 
the program from that point because the file will now be 
closed . 

RECORDS Argument Used for Unlabeled Tapes Only 

You cannot use the RECORDS argument to the SKIP command when 
using a labeled tape, because read and write operations for 
labeled tapes always move the tape to the beginning of a 
f ile . 
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Warning 


Skipping Past LEOT (Unlabeled Tapes Only) 

If you specify too large a value for n in the SKIP command 
line, you can move past the logical end of tape (LEOT). In 
this case, the operator may have to intervene before your 
tape control commands will have effect again. You must be 
sure how many files you have in the tape set if you use 
SKIP n rather than SKIP LEOT. This problem can occur for 
any tapes mounted on drives of the form MTAn : , or for 
unlabeled tapes mounted on drives of the form MTn : . 


Effect on Memory and Terminal 


The SKIP command does not affect memory and leaves your terminal 
at TOPS-20 command level. 


Related Commands 


UNLOAD for rewinding a magnetic tape completely onto the 

source reel (only for tapes mounted on drives having 
device names of the form MTAn:) 


Examples 


1. Skip over the next 2 files on the magnetic tape you are using 
(mounted on magnetic tape drive MTO: in this case). 

i SKIP MTO: 2 FILES 
@ 

2. Skip over the next two records on an unlabeled tape. 

e SKIPMTAQ: 2 RECORDS 

@ 
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3. Use the MOUNT command to ask the operator to mount your tape 
in write-enabled mode, then copy 3 files to the tape from 
your directory on structure SNARK:. Use the REWIND command 
to go back to the beginning, and the SKIP command to skip 
over the first file. Use the COPY command to have the next 
file (FIL-2) printed on your terminal, then give the SKIP 
command again to skip to the logical end-of-tape. You are 
skipping only one file, FIL-3, in this case. 

B MOUNT TAPE Dft Y ;/ NR I TE - ENABLED 
[ M o u ri t Request DAY Queued t Resuest-ID 1 B 7 ] 

[Tape set D A Y i volume DAY m o u n ted] 

[DAY: defined as M T 0 : ] 

B RENIND DAY: 

6 MQUNT STRUCTURE SNARK: 

Structure SNARK: mounted 
B ACCESS SNARK : 

B COPY 5NARK:FIL-1 .TAP DAY: 

SNARK : FIL- 1 .TAP. 1 => MT0:FIL-1 [OK] 

B COPY SNARK : FIL-2. TAP DAY: 

SNARK : FIL-2. TAP. 1 => MTO: FIL-2 [OK] 

B COPY SNARK : FIL-3 . TAP DAY: 

SNARK : FIL-3 . TAP . 1 => MTO: FIL-3 [OK] 

B RENIND DAY : 

6 5KIP DAY: 1 
B COPY DAY: TTY: 

MTO: => TTY: 

! THIS IS THE SECOND FILE. ! 

6 S K I P DAY: LEOT 

B 
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Function 


The START command begins execution of the program currently in 

memory . 


Format 


@ START (PROGRAM) location 
where 

location is the octal or symbolic address where you want the 
program to start 

Default location - the normal starting address, that 

is, the first word in the program's 
entry vector 


Hints 


Further Information 

For more information about entry vectors, see the TQPS-20 
Monitor Calls Reference Manual. 


Special Cases 


Running COBOL Programs a Second Time 

After running a program (with a RUN or EXECUTE command, or 
with a GET and START or LOAD and START combination) you can 
usually run it again using START. COBOL programs are an 
exception: to run them again you must reload them. 


Effect on Memory and Terminal 


The START command starts the program in memory at the specified 
address, and leaves your terminal at whatever mode the program 
puts it in. 


Related Commands 


CONTINUE 

GET 

LOAD 


for resuming execution of a halted program in memory 

for placing executable programs in memory 

for loading source or object programs into memory 
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REENTER for starting the program in memory at its alternate 
entry point (if any) 

SAVE for saving a loaded program in an .EXE file 


Examples 


1. Start the program currently in memory. 

B START 

2. Put an executable program in memory and start it. Then run 
it again. 

6 GET TESTF1 . EXE 
B ST ART 

THIS IS A TEST. 

END OF EXECUTION 

CPU TIME: 0.04 ELAPSED TIME: 0.23 

EXIT 

B START 

THIS IS A TEST. 

END OF EXECUTION 

CPU TIME: 0.02 ELAPSED TIME: 0.02 

EXIT 

B 


3. Begin using the FILCOM program to compare two files. Give a 
CTRL/C to halt FILCOM, then a CTRL/T to determine the 
location where it was stopped. Give the DDT command, and do 
some work within the DDT program; leave DDT with a CTRL/Z, 
returning to TOPS-20 command level. Give the START command 
to start FILCOM again, using as argument the address reported 
by CTRL/T above. 

B FILCDM 

* TTY : =DUMPER . MAC . BACKUP. MAC 

@ FILCOM '"C from Running at 400543 Used 0:00:03.1 
in 0:01:33# Load 2.24 

B DDT 

DDT 

3_/ PAT . . +3E1 # » 3 0 6 B 
4/ 5B 

“7 

B START 400543 

No differences encountered 

*2_c 

B 
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Function 


The SUBMIT command places requests in the batch input queue (list 
of jobs waiting to be processed by the batch system) . 


Format 


@SUBMIT (BATCH JOB) /switch (es) f ilespec/switch (es) , . . . 


where 

switches 


f ilespec 


are keywords, chosen from the list below, indicating 
your choice of SUBMIT command options. These 
switches have different effects according to their 
position in the command line: placed before all 
files in the command, they act as defaults for all; 
otherwise they affect only the nearest preceding 
f ile . 

Defaults are shown in the list of switches 

is the specification of a batch control file (see 
the TQPS-20 User's Guide ) , containing batch commands 
and the commands with which you would have done the 
job as a timesharing user instead of as a batch user 
Default file type - .CTL 

means that after a comma you can give more arguments 
(filespec and switches) of the form already shown 


Summary of SUBMIT Command Switches (defaults in boldface) 


/ACCOUNT : account Default account - your current 

account 

/AFTER:date and/or time 
YES 

/ASSISTANCE: NO 

APPEND 

/BATCH-LOG: SUPERSEDE 
SPOOL 


/BEGIN :n 

Default 

n - 0 

/CARDS :n 

Default 

n - 1000 

/CONNECTED-D I RECTORY :dev:<directory> 
/DELETE 


/DEPENDENCY-COUNT : n 
/DESTINATION-NODE : node name 

Default 

n - 0 

/FEET: n 

Default 

n - 200 

/JOBNAME: 6-character name 

KEEP 

/LOGDISPOSITION: DELETE 

Default 

name - first six characters 
of control filename 

/LOGNAME : filespec 

Default 

filespec - control 

filename, file 

type .LOG 
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YES 

/NOTIFY :N0 

ALWAYS 
/OUTPUT: ERRORS 
NOLOG 

/PAGES : n Default n - 200 

/PRIORITY : n Default n - 10 

/PRESERVE 

/PROCESSING-NODE : node name 
/READER 

NO 

/RESTARTABLE: YES Default argument (if switch is 

given) - YES 

/SEQUENCErn 

/TAG: 6-character label 

/TIME : hh : mm : ss Default time limit (if switch is 

omitted) - 00:05:00 
Default hh:mm:ss (if switch is 
given without colon or 
argument) - 60 (minutes) 
/TPLOT : n Default n - 200 

NO or 0 
/UNIQUE: YES or 1 
/USER:user name 


SUBMIT Command Switches 


/ACCOUNT: account specifies the account of 39 or fewer 

characters to charge for your batch 
request. This account must be valid 
for your user name. 

Default account - your current 

account (check 
with 

INFORMATION 

JOB-STATUS) 

/AFTER:date and/or time, or 

day of week (or TODAY) 

and/or time ensures that the job will not be 

started until after the date and/or 
time specified. NOV-12-79, and 
18:00:00 illustrate two arguments to 
this switch. If you give both date 
and time, separate them with a space. 
When given alone, the time may be 
preceded with a plus sign (+) , which 
will delay processing by the 
indicated length of time from the 
present . 
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SUBMIT 


YES 

/ASSISTANCE:NO 


APPEND 

/BATCH-LOG: SUPERSEDE 
SPOOL 


/BEGIN : n 


/CARDS :n 


/CONNECTED-DIRECTORY: 


/DELETE 


/DEPENDENCY-COUNT :n 


Command Switches (Cont.) 


Alternatively, you may give a day of 
the week (e.g., MONDAY) or TODAY as 
argument; then the batch job will 
not be started until the beginning of 
the following day. If you follow 
this argument with a plus sign and a 
time, the job will be further delayed 
by this amount. 


tells the system whether your job 
will require the assistance of the 
operator (e.g., to mount a structure 
or magnetic tape) when it is run 
Default - YES 


tells the system either to append 
the log file of the batch job to any 
existing log file of the same name, 
or to write a new generation of the 
log file, or to send the log file to 
the spool area only 

Default - APPEND 

starts processing the control file at 
line n of the file. Use this switch 
for a control file that can fit 
different applications depending on 
where processing begins. (See also 
the /TAG switch.) 

Default n - 0 

limits to n the maximum number of 
cards to be punched by the job 
Default n - 1000 

dev : <d ir ectory > 

specifies the connected directory for 
the batch job. For privileged users 
only. 

tells the system to delete the 
control file after the batch job has 
run 

sets the job's dependency count to n. 
Because a batch job does not get 
processed until its dependency count 
is 0, you can delay a job by 
assigning it a positive dependency 
count and then using the MODIFY 
command to bring the count to 0 at 
the proper time. 

Default n - 0 
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SUBMIT Command Switches (Cont.) 


/DESTINATION-NODE : node name:: 

specifies the DECnet remote job entry 
station on whose line printer the log 
file of your batch job is to be 
printed. The node name must be of 
six or fewer characters and must be 
followed by two colons (::). 

/FEET:n limits to n the maximum number of 

feet of paper tape to be punched by 
the job 

Default n - 200 

/JOBNAME :name assigns a name (of six or fewer 

characters) to the batch job 

Default name - first six 

characters of 

control filename 


KEEP 

/LOGDISPOSITION: DELETE 


/LOGNAME : f ilespec 


YES 

/NOTIFY :NO 


ALWAYS 
/OUTPUT: ERRORS 
NOLOG 


/PAGES :n 


tells the system whether to delete 

the log file after it has been 

printed 

Default - KEEP 

specifies where to place the log file 
of the batch job 

Default dev : <d irectory> - your 

connected directory at 

the time of the SUBMIT 

command 

Default filename - control 

filename 

Default type - .LOG 

tells the system whether to send a 
message to your terminal when the 
batch job has been completed 
Default argument - NO 

Default argument (if switch is 

given) - YES 


says whether you want the log file to 
be printed always, or only in the 
case of unhandled errors occurring 
within the job, or never. No matter 
which option you choose, the log file 
is always written. 

Default - ALWAYS 

limits to n the maximum number of 
pages of line printer output to be 
printed by the job 

Default n - 200 
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SUBMIT Command Switches (Cont.) 


/PRESERVE tells the system not to delete the 

control file after the batch job has 
run 

Default 

/PRIORITY : n assigns a decimal number n to the 

job, reflecting the urgency of the 
batch request. This n must be from 0 
to 63, with larger numbers receiving 
earlier treatment. 

Default n - 10 

/PROCESSING-NODE :node name:: 

specifies the IBM host system on 
whose CPU the JCL batch job is to be 
run. The node name must be of six or 
fewer characters and must be followed 
by two colons ( : : ) . 

/READER tells the system that your control 

file is composed of card images, 
including control cards, on disk. 
For details see the TOPS-10/20 Batch 
Reference Manual. 

NO 

/RESTARTABLE : YES decides whether the job should be 

started again if the system crashes 
and is restarted 

Default argument - NO 

Default argument (if switch is 
given) - YES 

/SEQUENCE : n specifies that n, instead of a number 

supplied by the system, is to be the 
sequence number of the job 

/TAG:label starts processinq the control file at 

the line beginning with label::, 
where label is an alphanumeric name 
of six or fewer characters. Use this 
switch for a control file that can 
fit different applications depending 
on where processing begins. 

/TIME :hh :mm: ss limits the maximum amount of CPU time 

available to the job; given in 
hours, minutes, and seconds. 

Default time limit (if switch is 
omitted) - five minutes 

Default hh:mm:ss (if switch is 
given without colon or 
argument) - 60 (minutes) 
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SUBMIT Command Switches (Cont.) 


/TPLOT : n 


NO (or 0) 
/UNIQUE : YES (or 1) 


/USER:user name 


limits to n the maximum number of 
minutes of plotter time allowed for 
the job 

Default n - 200 

declares, if two or more batch jobs 
are to use the same connected 

directory, whether they must be run 
at separate times 
Default - YES 

specifies the user who is to be the 
owner of the batch request. For 
privileged users only. 


Output 


Jobname , Request ID, and Time Limit 

As soon as you complete a valid SUBMIT command, the system 
responds by printing, on your terminal, the jobname, request 
ID, and time limit for the job. Each control file you 
submit is a separate batch request, and is described on a 
separate line. 


Characteristics 


Ordinary Operation - No Switches 

For most purposes you can use the SUBMIT command with just a 
filespec, or a series of filespecs, for arguments. 

Switch Defaults Set by System Manager 

The defaults shown in the list of switches are correct for 
most user sites. However, your system manager can change 
some of these default settings. The changes go into effect 
during system installation. The switches most commonly 
affected are: /CARDS, /FEET, /OUTPUT, /PAGES, /PRIORITY, 
/TIME, and /TPLOT. 

Disposition of Log Files 

The three SUBMIT command switches /BATCH-LOG, 
/LOGDISPOSITION , and /OUTPUT, control what happens to the 
log file of your batch job. 
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Where Written 

The log file is always written as the job runs, either to 
the batch job's connected directory, or to a directory 
specified as argument to the /LOGNAME switch, or to the 
system's output spooling area (it is written to the spooling 
area only if you give the /BATCH-LOG : SPOOL switch). If the 
/DESTINATION-NODE switch is also given, the log file will be 
written into a directory or spooling area at the specified 
node. Remember that a batch job's connected directory is 
ordinarily defined to be your connected directory at the 
time of the SUBMIT command; privileged users may specify a 
batch job's connected directory by using the 
/CONNECTED-DIRECTORY switch. 

How Written, When Printed 

The /BATCH-LOG switch's APPEND and SUPERSEDE arguments 
describe the manner in which the log file is to be written: 
either it is appended to any existing file of the same name 
(usually produced by a previous running of the batch job) or 
it is written as a new generation of the file. The 
/LOGD IS POSIT ION switch tells the system whether to keep this 
file, wherever it is written, once the batch job is 
finished. The /OUTPUT switch specifies when you want a 
listing of the log file to be printed: either always, or 
never, or only if errors occur when the batch job is run. 
By using combinations of these switches you can cause any 
desirable action. Giving /OUTPUT: ALWAYS along with 
/LOGDISPOSITION : DELETE allows a record of your batch job 
with only a temporary use of your disk area, and permits you 
to monitor the progress of the job while it is running (give 
TYPE commands to view the file at your terminal). Giving 
just the /BATCH-LOG : SPOOL switch allows a record without any 
use of your disk area, although then you must wait for the 
printed output to see this record. 


Hints 


Using SET DEFAULT SUBMIT 

If there are switches that you always or usually supply when 
using SUBMIT, give the SET DEFAULT SUBMIT command to 
establish them as defaults for the remainder of your 
terminal session. The switches will then behave as if you 
had typed them directly after the word SUBMIT. You can 
supersede any of these default switches by actually 
supplying the switch, with another value, when you give the 
SUBMIT command. 


294 



SUBMIT (Cont.) 


For Future Terminal Sessions 

Put SET DEFAULT SUBMIT commands into a file of 
specification COMAND.CMD or LOGIN.CMD in your 
log-in directory if you want these default 
switches to be in effect for batch jobs you submit 
during future terminal sessions as well. If both 
files exist, the sycem reads LOGIN.CMD first. 

For Nested Batch Jobs Only 

Put SET DEFAULT SUBMIT commands into a file of 
specification BATCH.CMD in your log-in directory 
if you want them to be in effect at the log-in 
time of a "nested" batch job only, that is, a 
batch job started by a SUBMIT command within the 
control file of another of your batch jobs. Note, 
however, that the system also reads COMAND.CMD at 
the log-in time of a batch job if the file exists 
in your log-in directory. It reads this file 
after BATCH.CMD. 

More Information 

For more information about batch jobs, see the TOPS-10/20 
Batch Reference Manual. 


Restrictions 


Access Rights for Batch Jobs 

For Specifying Control Files and Log Files 

You cannot use the ACCESS command to obtain the right 
to submit control files from another directory, because 
your batch jobs are logged in with rights only to your 
connected directory and to directories to which you 
have access as a group member. The control file, if 
not in your connected directory, must be in one to 
which you have read access as a group member; the log 
file specification, if you give one, must be for your 
connected directory or for one to which you have write 
access as a group member. 

For Use Within the Batch Job 

Although it is possible to give CONNECT and ACCESS 
commands within a batch job to obtain rights beyond 
those mentioned above, you may then have to include 
passwords in the job's control file. Because this 
practice could endanger system security, it is 
generally best to establish and rely on appropriate 
group rights when preparing batch jobs for submission. 


Effect on Memory and Terminal 

The SUBMIT command does not affect memory and leaves your 
terminal at TOPS-20 command level. 
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Related Commands 


CANCEL for withdrawing SUBMIT requests 

INFORMATION BATCH-REQUESTS for examining in the batch input 

queue 


MODIFY for changing SUBMIT requests 

before processing has begun 

SET DEFAULT SUBMIT for establishing default switches 

for subsequent SUBMIT commands 


Examples 


1. Submit a control file to begin a batch job. 

B SUBM I T DIFS . CTL 

[Job DIFS Queued > R e a u e s t - I D 4 6 1 > Limit 0:05:00] 

S 

2. Submit two control files (specifying only the filenames) in 
the same command. Then use the INFORMATION BATCH-REQUESTS 
command (with the USER switch) to examine your entries in the 
batch input queue. 

6 5UBMIT SUMS > DIFS 

[Job SUMS Queued) R e s u e s t - I D G 2 9 i Limit 0:05:00] 

[Job DIFS Queued ) Resuest-ID G 3 0 > Limit 0:05:00] 

6 I NFDRMAT I ON BATCH - REQUESTS /USER 

Batch Queue: 

Job Name Res# RunTime User 


* SUMS G29 00:05:00 C . BURKE In St ream : 2 

Started at 15:21:01 
DIFS G30 00:05:00 C. BURKE 

There are 2 Jobs in the Queue (1 in Prodress) 

B 
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3. Connect to another user's directory, then submit two of his 
control files. Prevent the printing of a log file for one 
job, and allow the second job's to be printed only if errors 
occur within the job; make both jobs restartable. Request 
an inclusive listing of your entries in the batch queue - 
notice that the jobs are logged in under your own user name, 
although the log files will be stored in user Holland s 
directory. Note also that an asterisk (*) indicates a job 
currently in progress. 

Connect back to your directory and submit one of your own 
control files, specifying a particular jobname, then check on 
it . 

B CQNNECT < H 0 L L ft N D > 

B 5 U B M I T 'Vr EST ftRTABLE : YES FLDTST . CTL/DUTPUT : NDLOG > LODT 
ST. CTL/OUT PUT: ERRORS . 

[Job FLDTST Queued * Resues t - I D 4G4 t Limit 0 : 05 : 00 1 
[Job LODTST Queued » Request-ID 465 t Limit 0:05: 00 ] 

@ I NFQRMAT I ON BATCH-REQUESTS / ftLL/USER 

Batch Queue: 

Job Name Req» RunTime User 


♦ FLDTST a G 4 00:05:00 C. BURKE In Stream :2 /Unis : Y e s 

/Restart: Yes /Assist: Yes /Seq:1993 
Started at 8:40:38 

LODTST 4 G 5 00:05:00 C . B U R K E / U n i q : Y e s /Restart: Yes 

/Assist: Yes /Seq:1994 
There are 2 Jobs in the Queue (1 in Progress) 

B CONNECT M ISC: <C, BURKE > 

6 5UBMIT SUNS/ JOBNAME : 1 -SUMS 

[Job 1 -SUMS Queued > Resuest-ID 4GG i Limit 0:05:001 
B I NFQRMAT I ON BATCH - REQUEST S /ALL/USER 

Batch Queue: 

Job Name Req# RunTime User 


* 1 - S U M S 4 G G 00:05:00 C . B U R K E In Stream:! / U n i q : Y e s 

/Restart:No /Assisf.Yes /Seq:1995 
Started at 8:41:29 

There is 1 Job in the Queue (1 in Progress) 

B 
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4. Give a SET DEFAULT command to ensure that your batch jobs 
w iH. be run after 5:00 P.M. unless you specify otherwise. 
Submit a batch job and check that this default is in effect. 
Then use a MODIFY command to delay the starting time of this 
job till 11:00 P.M. Finally, give the CANCEL command to 
withdraw the batch request entirely. 

@ 5ET DEFAULT SUBMIT /AFTER: 17:00 
0 SUBMIT SUMS 

[Job SUMS Queued » Resuest-ID 4 G 7 > Limit 0 : 05 :OO] 

0 I NFORMAT I UN BftTCH - REQUESTS /USER 

Batch Queue: 

J o b N a m e Res# RunTime User 


SUMS 4G7 00:05:00 C . BURKE /Af t e r : 9-Nou -79 17 : 00 

There is 1 Job in the Queue (None in Progress) 

0 MDDIFY BATCH 467 / AFTER ■■ 23 : 00 
Cl Job Modified] 

0 I NFORMAT I ON BATCH - REQUESTS /USER 
Batch Queue: 

Job Name Res# RunTime User 


SUMS 4G7 00:05:00 C . BURKE / Af t e r : 9-No v -79 23 : 00 

There is 1 Job in the Queue (None in Progress') 

@C ANCEL BATCH 4S7 


Cl Job Canceled] 
0 
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Function 


The SYSTAT command prints information about the current state of 
the system. 


Format* 


@ SYSTAT, 

@ @subcommand 

@@ . 


where 

means that, after a comma, you can give one or 
@@ more subcommands on successive lines 

@@ . 


subcommand is a keyword, chosen from the list below, 

indicating your choice of SYSTAT command options 

Defaults are shown in the list of subcommands 


Summary of SYSTAT Command Subcommands (defaults in boldface) 


ALL 

CLASS 

CONTROLLING 

DIRECTORY 

HEADER 

JOB job number n 
LIMIT 

LINE octal line number, or DETACHED 
LPT 

NO subcommand name, or OPERATOR, or . 

OUTPUT file specification 

PROGRAM 

STATE 

SYSTEM 

TIME 

USER user name 

WHAT 

WHERE 

WHO 


* For information on the in-line subcommand format, refer to the 
"Hints" section below. 
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ALL 

CLASS 


CONTROLLING 

DIRECTORY 

HEADER 

JOB n 

LIMIT 

LINE octal line 

LPT 


SYSTAT Command Subcommands 


gives all available SYSTAT information 

prints the scheduler class in which each job 
is running; the share of total CPU time 
allotted to the job, expressed as a decimal 
fraction; and the fraction of total CPU 
time actually used by the job. A job's 
actual use may be larger than its allotted 
share if some jobs in its class are 
inactive; it can be larger still if other 
classes are inactive and this unused 
fraction of CPU time is being allocated 
among active jobs. 

prints, in the column headed C JB , the number 
of the controlling job (if any), that is, a 
job owning a PTY (pseudo-terminal) that 
controls the job being described; when 
used in a SYSTAT command requesting 
descriptions of particular jobs, this 
subcommand causes jobs controlled by these 
jobs to be described also. 

requests the name of the directory to which 
each job is connected, if not the job's 
log-in directory 

calls for a headline identifying the columns 
of information printed 

Default (unless you are requesting 
information about specific 
users, jobs, or lines only; in 
such cases the default is NO 
HEADER. ) 

restricts output to description of job 
number n; can be used more than once. 

prints any time limit set for each job 

number or DETACHED 

restricts output to description of the job 
attached to the given line number, or to 
descriptions of all detached jobs; can be 
used more than once. 

sends output to the line printer instead of 
to your terminal 
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SYSTAT Command Subcommands (Cont.) 


NO 


f . (period) 
CLASS 

CONTROLLING 
l DIRECTORY 
| HEADER 
} LIMIT 
' OPERATOR 
STATE 
SYSTEM 
TIME 
WHAT 
WHERE 
\ WHO 


OUTPUT filespec 


eliminates the indicated category of 
information, when used with one of the 
keywords shown (. refers to your own job) 


sends the output information to the file you 
specify, instead of to your terminal 
Default filespec - SYSTAT. LST 


PROGRAM program name restricts SYSTAT output to descriptions of 

jobs using the program (or TOPS-20 command) 
specified. The argument you supply must be 
of six or fewer characters. 


STATE 


SYSTEM 


TIME 

USER user name 


WHAT 


WHERE 


WHO 


prints the current state of each job, i.e., 
RUN (running) , or TI (waiting for terminal 
input) 

begins output with system-wide information, 
i.e., the first two lines of reqular output. 
If SYSTEM is the only subcommand given, 
SYSTAT output is restricted to this. 

Default (unless you give subcommands 
requesting information about 
specific users, jobs, or lines 

only; in such cases the 

default is NO SYSTEM.) 

prints the accumulated runtime (CPU time) 
for each job 

restricts output to descriptions of jobs 
logged in under the given user name; can be 
used more than once. 

prints the name of the program that each job 
is running; given explicitly only with 

subcommand NO, to restrict SYSTAT output. 
Default 

prints the line number associated with each 
job; given explicitly only with subcommand 
NO, to restrict SYSTAT output. 

Default 

prints the user name under which each job is 
logged in; given explicitly only with 

subcommand NO, to restrict SYSTAT output. 
Default 
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Output 


Sample of SYSTAT Output 

The SYSTAT command prints on your terminal up to 12 columns 
of information about all the jobs on the system. Below is a 
sample of the output you would receive in response to a 
SYSTAT command that eliminates the two rightmost columns 
(User and <Directory> ) : 

0SYSTAT ALL NO WHO NO DIRECTORY 
Tue 14-Aug-79 15:48:37 Up 1:12:59 

45+11 Jobs Load av (class 0) 3.70 3.54 3.71 


Job 

CJB 

Line 

Program 

State 

Time 

Cls 

Shr 

Use Limit 

5 


25 

TV 

RUN 

0:01:02 

0 

0.01 

0.03 

7 


6 

TV 

T I 

0:00:35 

0 

0.01 

0.02 

13 

35 

217 

EXEC 

RUN 

0:01:02 

1 

0.15 

0.00 

First 

you 

see 

the current 

date and 

time (in 

24-hour 

notation : 

the 

sample 

above 

was obtained 

37 seconds after 


3:48 P.M.) , and the length of time since the system was 
started (here, just over 1 hour). 


The second line displays the number of user jobs (45) and 
operator jobs (11) currently running. The next three 
numbers are the "load averages" for the system: these are 
weighted averages of the number of runnable processes on the 
system over the last minute, 5 minutes, and 15 minutes, 
respectively. (If class scheduling is enabled, the three 
load averages are the average number of jobs having at least 
one runnable process, and apply to the class in which your 
job is running.) If you are about to start a job requiring 
5 minutes of CPU time, and the load average remains stable 
over the period in question, i.e., becomes 4.54 (3.54 + your 
job = 4.54), then you can count on your job's getting about 
1/4.54 of your class's share of the system's attention. If 
your class is assigned one third of the system's CPU time 
and you do not receive any windfall (unclaimed CPU time), 
your job will be finished in a little over one hour. 

After this comes the line of headings labeling each column 
of data that follows. All but the User and <Directory> 
columns of information appear in the sample above, 
describing all jobs (rows). The unmodified command SYSTAT 
gives only columns 1, 3, 4, and 11 (User) for each job; by 
using appropriate subcommands you can select the categories 
of information presented, as well as the specific jobs 
examined. (The Class (Cls) and Share (Shr) categories 
appear only if class scheduling is enabled.) User jobs, 
both timesharing and batch, are listed first (in ascending 
order by job number) , and then, after a blank line, operator 
jobs. The number of the job attached to your own terminal 
appears with an asterisk (*) next to it in the Job column. 
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Sending Output Elsewhere 

By giving the OUTPUT subcommand you can direct SYSTAT 
information to a file instead of to your terminal. The 
subcommand LPT sends the information to the line printer 
instead of to your terminal. 


Characteristics 


Log-in Not Necessary 

You do not have to be logged in to give the SYSTAT command. 


Hints 


Reducing Charges for SYSTAT 

You can use subcommands to restrict the jobs surveyed and 
the information requested; this will reduce the CPU time 
needed to process the command. If you decide to cut off the 
SYSTAT output before it is done, give CTRL/Cs rather than a 
CTRL/O. This stops not only the output but also the CPU 
charges for producing it. 

Giving Subcommands as Arguments on the Command Line 

To simplify your typing, SYSTAT accepts subcommands as 
arguments given on the same line as the command, subject to 
these rules: 

There will be no @@ prompt: simply type a space 

between successive subcommands and between subcommand 
names and arguments. 

To get information about one or more specific job 
numbers, give the numbers only; do not type JOB. 

To get information about one or more specific user 
names, give the names only; do not type USER. But if 
the user name is by coincidence the same as a SYSTAT 
command argument, you must use the subcommand mode to 
request information about his job. 

To get information about one or more specific log-in 
directories, give the directory names . 1 

To get information about your own (attached) job only, 
give a period (.) as argument. 


1 For specific connected directories, specify the directory names 
(and structures, if not the public structure) along with either the 
ALL or DIRECTORY subcommand. 
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To get information about all other jobs logged in under 
your user name, give your user name and NO . as 
arguments . 

The system will not accept the OUTPUT subcommand in 
this format; use the subcommand mode instead. 


Special Cases 


OPERATOR as a User Name 

You can request or refuse information about operator jobs by 
treating OPERATOR as a user name. The system accepts these 
commands : 

0SYSTAT OPERATOR 


and 


@SYSTAT , 

@ @USER OPERATOR 

as well as the special commands 
0SYSTAT NO OPERATOR 

and 

0SYSTAT, 

@ @N0 OPERATOR 

Effect on Memory and Terminal 


The SYSTAT command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


INFORMATION 


for finding out other information about the 
system 
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Examples 

1. Find out the status of all jobs on the system. (Your current 
(attached) job is marked with an asterisk (*).) 

BSYSTAT 


F r i 

1 - J u n - 

79 12:28:25 

Up 33 : 3G : 17 

7 + 2 

Jobs 

Load ay (class 0) 1.97 

Job 

Line 

P r o 3 r a fit 

User 

3 

44 

EXEC 

R.CRISS 

5 

5G 

MACRO 

D . SCHEIFLER 

B 

DET 

N0TTMP 

Not 1 o 3 3 e d in 

9 

103 

TO 

F0RTMILLER 

1 1 

57 

TO 

SC0HEN 

14* 

207 

EXEC 

LATTA 

20 

114 

TO 

HARDY 

51 

41 

NEWRUN 

LATTA 

7 

DET 

PERF 

OPERATOR 

4G 

3 

DUMPER 

OPERATOR 


@ 


2. Determine how much CPU time has been charged to the jobs of 
two users on the system. 

B SYSTAT > 

BB T I ME 
60 U5ER KONEN 
BB USER ALUSIC 
00 

27 GG EXEC 0:00:01 ALUSIC 

43 11 EXEC 0:00:02 KONEN 

0 

3. Repeat Example 2 by giving the subcommands as arguments on 
the same line. 

B SYSTAT TINE KONEN ALUSIC 

27 GG EXEC 0:00:01 ALUSIC 

43 11 EXEC 0:00:02 KONEN 

0 

4. Find out who is using line 11. 

B SYSTAT LINE 11 

43 11 EXEC KONEN 

0 
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5. Ask for information about jobs 5 and 45. 
B SYSTAT 5 45 

5 5G MACRO D.GCHEIFLER 

45 205 PTYCON OPERATOR 


6. Set a time limit of 4 seconds for your attached job, then ask 
for complete information, including headings, for the job. 
(The period (.) specifies your attached job.) The value 
reported under the Limit heading is actually the sum of the 
time limit you set (4 seconds) and the amount of CPU time 
already used at the time of your SET command (2 seconds). 
This CPU time is reported as 2 seconds under the Time heading 
because you gave the SYSTAT command immediately after SET. 

@ 5ET TIME-LIMIT 4 
B SYSTAT ALL HEADER . 

J a h C J B Line Program 

Limit User* <Di rectory) 

14* 51 207 EXEC 

0:00: OB LATTA. M I SC : < LATT A > 

B 


State Time Cls 

Sh r 

Use 

RUN 0:00:02 0 

0 . 0 2 

0 ♦ 0 2 


7. Ask for system-wide SYSTAT information only. 
B SYSTAT SYSTEM 

Fri l-Jun-79 12:35:44 Up 33:43:3G 

18+15 Jobs Load a v (class 0 ) 5.19 3.3B 2.92 


8. Find out only which programs are in use. 


9 . 


BSYSTAT NO NHD NO WHERE NO SYSTEM 


Job 

Proiram 

<7 

EXEC 

3 

EXEC 

4 

EXEC 

5 

MACRO 

B 

UTEC0 

8 

NUTTMP 

9 

EXEC 

13 

0 PLEAS 

IS 

LPTSPL 

2S 

OPR 

28 

BATC0N 

B 


Ask for a 

list of jobs controlled 

job, marked with an asterisk (*) , 
job 51 itself is the other.) 

BSYSTAT 51 

CONTROLLING 

14* 51 

207 EXEC LATTA 

51 

41 NEWRUN LATTA 


B 


by job 51. (Your attached 
happens to be one of these; 
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Function 

The TAKE command tells the system to process TOPS-20 commands 
stored in the specified file. 


Format 


@TAKE (COMMANDS FROM) filespecl (LOGGING OUTPUT ON) filespec2, 
@@subcommand 


where 

filespecl 


f ilespec2 




subcommand 


is the specification of the file containing the 
commands to be processed 

Default file type - .CMD 

is the name of the file or device you want to 
receive any output of the commands. This field 
will be removed in the next major release of 
TOPS-20 . You are encouraged to begin using the 
new LOG-FILE subcommand (see below) now. 

Default filespec2 - TTY: (your own terminal) 

means that after a comma you can type one of the 

subcommands below, indicating your choice of TAKE 
command options 

can be one or more of these: 

ALLOW which tells the current level of 

TOPS-20 , for the remainder of the 
terminal session (not merely the 

current command), to continue 

processing a command file if it 
encounters errors 

DISALLOW which tells the current level of 

TOPS-20, for the remainder of the 
terminal session (not merely the 

current command) , to ignore any 

remaining commands in a command file 

after it encounters an error in the 
file 

Default 

ECHO which tells the system to print (on 

your terminal or in the specified file) 
the commands that it carries out while 
executing the current TAKE command. 
Ordinarily only the output, if any, 
produced by the commands is printed. 
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NO ECHO 


which tells the system not to print the 
commands that it carries out while 
executing the current TAKE command. A 
final message is sent, however, 
indicating whether all the commands 
were executed. See also 
Hints - Suppressing the Final Message, 
below . 

Default 


LOG-FILE filespec 

which tells the system to save the 
output from the current TAKE command in 
the specified file. Note that use of 
this subcommand in place of "filespec2" 
is optional in TOPS-20 Version 5; 
"filespec2" will be removed in a future 
software release, and use of LOG-FILE 
will then be required. 


Output 


The output from a TAKE command consists of the output for each 
command in the command file you specify as argument, followed by 
the message, End of filespec, that indicates successful execution 
of all the commands in this file. 


Characteristics 

Running Programs From a Command File 

If you put commands that run programs (including the PUSH 
command) into a command file, and these programs ask for 
arguments, you must be ready to type in these arguments at 
your terminal. Only TOPS-20 commands and command arguments 
can be put into a command file executed by the TAKE command. 


Hints 


Suppressing the Final Message 

If you want to suppress the final message (of the form, End 
of filespec) that indicates successful execution of a 
command file by TAKE, give a TAKE command with no arguments 
as the last line of your command file. 


Special Cases 

Nested TAKE Commands 

In the case of nested TAKE commands (those given as commands 
within command files), the destination for output of 
commands given in an inner command file will default to that 
specified or assumed for the output of commands given in the 
nearest surrounding command file. 
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Effect on Memory and Terminal 

The TAKE command affects memory and your terminal according to 
the commands stored in the command file you specify as argument. 


Related Commands 

INFORMATION commands (when put into a command file) for 

tracing the progress of TAKE 

LOGIN for logging in; reads LOGIN.CMD then 

COMAND.CMD, in your log-in directory. 

PUSH for obtaining a new level of TOPS-20; 

reads COMAND.CMD in your log-in 

directory. 

SUBMIT for processing command files that run 

programs and contain program commands as 
well as TOPS-20 commands; reads 
BATCH.CMD, then COMAND.CMD, in your 
log-in directory. 


Examples 

1. Process a command file. 

S TAKE BACKUP . CMP 
End of BACKUP.CMD. 1 

@ 

2. Create a command file to report system statistics, then give 
the TAKE command with this filename as argument; send the 
output to the line printer. Check for this listing as it is 
being printed. 

B CREATE STATUS . CMP 

Input : STATUS . CMD . 1 

0 0 1 0 0 INFORMATION DISK-USAGE 

00200 INFORMATION MDN I TOR - ST AT I ST I C5 

0 0 3 0 0 INFORMATION SYSTEM-STATUS 

0 0 a 0 0 INFORMATION MEMORY-USAGE 

00500 5Y5TAT ALL 

0 0 6 0 0 $ 

* EJJ 

S TAKE STATUS LPT ; 

End of STATUS . CMD . 1 
S I NF0RMAT I ON OUTPUT -REQUESTS /USER 


Printer Queue: 

Job Name Rea# Limit User 


EXEC 507 27 LATTA 

There is 1 Job in the Queue (None in ProSress) 

0 
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Function 

The TALK command links your terminal to another user's terminal. 

Format 

@TALK (TO) argument 
where 

argument is either a user name or a terminal line number 

Characteristics 


Other Job Not Affected 


As soon as you give a 
terminals begin printing 
system's responses to that 
receive input from its own 

Ending TALK 

To end a conversation link 
can give the BREAK command 

Refused TALK 


successful TALK command, both 
both users' input as well as the 
input. Each job, however, will 
terminal only. 


between terminals, either user 


Ordinarily you cannot contact a user with TALK if his 
terminal is set to refuse links. In such a case your TALK 
command causes a series of CTRL/G signals at both 
terminals - usually ringing bells or high-pitched beeps. 
However, if you have Wheel or Operator capabilities enabled, 
you can talk to any user. 

Maximum of Four Terminals 

By using TALK commands you can join up to four terminals at 
once for sharing displays or printout. 


Hints 


Signaling a Linked User 

Once you have established links with another user's terminal 
via the TALK command, you can get his attention by typing a 
series of CTRL/Gs. Depending on the kind of terminal he 
has, these will be reproduced as ringing bells or 
high-pitched beeps. This action can be especially useful 
when establishing links with the owner of a display 
terminal, as display terminals are silent in ordinary 
operation. 
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Special Cases 


User Has More Than One Job 

If more than one job is logged in under the user name you 
specify, the system responds with a list of that user's 
terminal line numbers and the programs being run. Type your 
choice of terminal line number (if possible, one running the 
TOPS-20 command processor (EXEC)) after the TTY: prompt. 

Talking to a Batch Job or PTYCON Job 

When you link to a PTY (pseudo-terminal) to talk to the 
owner of a batch job or PTYCON job, the system informs you 
of this with a message, to which you must reply with a 
carriage return to confirm the link. To decline the link, 
give a CTRL/C. See also Warning, Talking to a Batch Job, 
below. 


Warning 


Talking to a Batch Job 

Use caution when communicating through a PTY 
(pseudo-terminal) that is controlling a batch job: do not 
send a question mark (?) or percent sign (%) , because these 
characters can be attributed to errors occurring within the 
job. Also, if an error actually does occur in the batch job 
and the batch system's question mark is displaced (by your 
remarks) from the beginning of a line, the system may not 
recognize it as an error. 

Talking Between a VT100 and a VT52 

If links between VT100 and VT52 terminals are established 
using a TALK (or ADVISE) command, the VT52 may function 
improperly during or after the linked interval (e.g., by 
requiring frequent CTRL/Q commands to print multiple lines 
of output) . Turning the terminal off and then on again 
(after the linked interval) will correct this problem. 


Effect on Memory and Terminal 

The TALK command does not affect memory and leaves your terminal 
at TOPS-20 command level. 
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Related Commands 


ADVISE 

BREAK 

RECEIVE LINKS 
REFUSE LINKS 
REMARK 


for sending commands to another user’s job 

for ending communications links involving your 
terminal 

for allowing other users to talk to you 

for preventing other users from talking to you 

for telling the system to regard your terminal 
input as comment only 


Examples 


1. Give the TALK command to establish links to another user. 
6 TALK H. DAVIES 

LINK FROM LATTA , TTY 230 
S 

2. Try to talk to a user who has given the REFUSE LINKS command, 
then use the MAIL program to send your message. 

B T ALK GEBHARDT 

?Refused> use "MAIL" to send mail to user 
B MA I L 

To : GEBHARDT 
CC: LATTA 
Subject : HUNCH 


@ 

3. Talk to another user, giving the REMARK command immediately 
after TALK. (The other user's reply must still be preceded 
by semicolons (;) or exclamation marks (!).) Give a CTRL/Z 
to end REMARK before typing the BREAK command to end the 
conversation. 

B TALK CARNAODN 

LINK FROM LATTA , TTY 230 
6 REMARK 

Type remark. End with CTRL/Z. 

NHERE DO I PUT " REQMD " RECORDS AFTER EXTRACTING THE ID'S? 

B 5 i n <accts>deft-77.obl 
B 5 y o u should haue j roup access there... 

THANKS 


B BREAK 

B 
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4. Give the TALK command to establish links to a user who has 
jobs on three different terminals; choose one of 
terminals running the TOPS-20 command processor. 

S TALK MCKAY 
TTY 19 » DUMPER 
TTY2G > EXEC 
TTY27 , EXEC 
TTY: 22 

LINK FROM LATTA , TTY 230 
@ 


3 

the 
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Function 


The TDIRECTORY ( Time-or der ed DIRECTORY) command is equivalent to 
the DIRECTORY command with the subcommands CHRONOLOGICAL (BY) 
WRITE, REVERSE (SORTING) , and TIMES (AND DATES OF) WRITE. Use 
the same format and subcommands with TDIRECTORY as with 
DIRECTORY. For further information, see the DIRECTORY command 
description in this manual. 

When used with magnetic tapes, the TDIRECTORY command is 
equivalent to DIRECTORY for magnetic tapes. 


Examples 


1. Give a TDIRECTORY command, truncating output with a CTRL/C 
"^tter the first few (most recent) files are displayed. 

B TDIRECTORY 


Write 


MISC : < LATTA > 
TBATCH.CMD. 1 
B. DIRECTORY. 1 
A. DIRECTORY. 1 
T.CMD.l _U3 

@ 


10 -May-79 13:11:57 
9 - M a y - 7 9 12:54:00 
2-May -79 13:14:52 


2. Access another user's directory, and request a time-ordered 
directory listing of all his files of a certain name. 

B ACCESS < D E 0 R I E S > 

P a s s w o r d : 

@ TD I RECTORY ! . D E 0 R I E S > SYSTEM.* 

Write 


MISC : < DEMR I ES > 

SYSTEM. MEM. 1 19-May -79 09:03:48 

♦ TXT . 1 19-May -79 09:02:08 

♦ RN 0.1 19-May-79 09:02:00 

Total of 3 files 
B END-ACCESS < D E 0 R I E 5 > 

B 
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Function 


The TERMINAL command lets you specify many of the operating 
characteristics of your terminal. 


Format 


0TERMINAL (MODE IS) argument 
where 


argument 


is a keyword, chosen from the list below, 
representing your choice of TERMINAL command 
options; some arguments further require a decimal 
number to complete their meaning. 


Summary of TERMINAL Command Arguments (defaults in boldface) 


33 

35 

37 

EXECUPORT 

FLAG 

FORMFEED 

FULLDUPLEX 

HALFDUPLEX 

HELP 

IMMEDIATE 
INDICATE 
LA3 0 
LA 3 6 
LA3 8 
LAI 20 

LENGTH n Default n - 66 

LINE-HALFDUPLEX 

LOWERCASE 

FLAG 

FORMFEED 
IMMEDIATE 
INDICATE 
LOWERCASE 
PAGE 

( END-OF-PAGE 
PAUSE \ COMMAND 
RAISE 
TABS 



315 



TERMINAL (Cont.) 


PAGE 

( CHARACTER x y 
PAUSE < END-OF-PAGE 
( COMMAND 


50 
75 
110 
134 
150 
200 
300 
600 
1200 
2400 
4800 
9600 

SYSTEM-DEFAULT 

TABS 

TERMINET 

TI 

TYPE 0-36 
VK100 
VT0 5 
VT5 0 
VT5 2 
VT100 
VT125 

WIDTH n Default n 


RAISE 


SPEED 


72 


TERMINAL Command Arguments 


33 


35 


informs the system that your terminal is a 
Teletype Model 33, which 

does not have a formfeed or tab 
mechanism 

prints lowercase letters as uppercase 

needs extra time to print tabs and 
certain paper-moving characters 

(formfeed and vertical tab) 

has a line width of 72 


has a page length of 66 


informs the system 
Teletype Model 
characteristics as 
has a formfeed and 


that your terminal is a 
35, which has the same 
a Model 33, except that it 
tab mechanism 
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37 

EXECUPORT 


FLAG 

FORMFEED 


FULLDUPLEX 


HALFDUPLEX 


HELP 

IMMEDIATE 


TERMINAL Command Arguments (Cont.) 


informs the system that your terminal is a 
Teletype Model 37, which has the same 
characteristics as a Model 33, except that it 
prints lowercase letters 

informs the system that your terminal is an 
EXECUPORT, which 

does not have a formfeed or tab 
mechanism 

prints lowercase letters 

needs extra time to perform a carriage 
return 

has a line width of 80 

has a page length of 66 

instructs the system to print a single 
quotation mark (') before it prints an 
uppercase character. This takes effect only 
if you also set the NO LOWERCASE parameter. 

informs the system that your terminal has a 
formfeed mechanism; otherwise the system 
simulates formfeeds by printing the correct 
number of linefeeds (set by the TERMINAL 
LENGTH command) if you have set^ TERMINAL NO 
INDICATE, or by printing an ~L if you have 
set TERMINAL INDICATE. 

instructs the system to send to your terminal 
each character as the program reads it; your 
terminal does not print what you type until 
the system sends the character back to the 
terminal. See also IMMEDIATE. 

Default 

inhibits the system from sending to your 
terminal each character, and assumes that 
your terminal will print each character 
itself; causes echoing of format control 
characters (e.g., TAB and linefeed). Be sure 
also to set any corresponding switch 
physically located on your terminal. 

prints information about the TERMINAL command 

instructs the system to echo each character 
as soon as you type it, instead of waiting 
until the program receives the character. 
Immediate echoing has effect only when the 
FULLDUPLEX parameter is also set. 
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TERMINAL Command Arguments (Cont.) 


INDICATE 


LA 30 


LA 3 6 


LA 3 8 


LAI 20 


instructs the system to print an ~L instead 
of advancing the proper number of lines 
whenever encountering a formfeed or CTRL/L 
(ASCII character 14) 

Default 

informs the system that your terminal is a 
Digital Eguipment Corporation LA30, which 

does not have a formfeed or tab 
mechanism 


prints lowercase letters as uppercase 

needs extra time to perform a carriage 
return, linefeed, tab and formfeed 

has a line width of 80 

has a page length of 66 

informs the system that .your terminal is a 
Digital Eguipment Corporation LA36, which 

does not have a formfeed or tab 
mechanism 


prints lowercase letters 

has a line width of 132 

has a page length of 66 

informs the system that your 
Digital Equipment Corporation 

does not have a formfeed 

prints lowercase letters 

has a line width of 132 

has a page length of 66 

informs the system that your 
Digital Eguipment Corporation 

prints lowercase letters 

has a line width of 132 

has a page length of 66 


terminal is 
LA38, which 

mechanism 


terminal is 
LA120, which 


a 


a 
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TERMINAL Command Arguments (Cont.) 


LENGTH n sets the number of lines printed on each 

page. (If you have TERMINAL PAUSE 

END-OF-PAGE set as well, the system stops 
after printing n lines and continues only 
when you type CTRL/Q.) If you set the page 

length to 0, the system stops printing only 
when you type CTRL/S (as long as TERMINAL 
PAUSE COMMAND is in effect also); it does 
not automatically stop at the end of a page. 

Default n - 66 

LINE-HALFDUPLEX inhibits the system from sending to your 

terminal each character, and assumes that 

your terminal will print each character 
itself; does not cause echoing of format 

control characters (e.g., TAB and linefeed). 

LOWERCASE tells the system that your terminal handles 

lowercase output characters properly, by 
printing either the lowercase character or 
the corresponding uppercase character. When 
NO LOWERCASE is set, the system converts 
lowercase output characters to the 
appropriate uppercase characters before 
sending them. See also the FLAG and RAISE 
parameters . 

Default 

NO argument reverses any of the arguments FLAG, FORMFEED, 

IMMEDIATE, INDICATE, LOWERCASE, PAGE, PAUSE, 
RAISE, and TABS 

Default - NO FLAG, NO FORMFEED, NO 
IMMEDIATE, NO PAUSE END-OF- 
PAGE, NO TABS 

PAGE n instructs the system to stop printing when it 

reaches the end of a page, or when you type a 
CTRL/S. Continue the output by typing a 
CTRL/Q. To set the page length, give the 
number n or give a TERMINAL LENGTH command. 
If you set the page length to 0, the system 
stops printing only when you type a CTRL/S. 

Default n - argument of any TERMINAL 
LENGTH command given in the 
current terminal session, 
or the default page length 
for your terminal type 
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TERMINAL Command Arguments (Cont.) 


0 ( CHARACTER x y 

PAUSE \ END-OF-PAGE 

(COMMAND instructs the system to stop sending output 

whenever it has sent a full page 
(END-OF-PAGE) or whenever you type CTRL/S 
(COMMAND) or x (CHARACTER) . 

For argument END-OF-PAGE to stop your output, 
argument COMMAND must also be in effect. You 
continue the output by typing CTRL/Q or the y 
parameter of the CHARACTER argument. 

For argument CHARACTER to stop your output, 
the COMMAND and END-OF-PAGE arguments must be 
in effect. With the CHARACTER argument, you 
continue output by typing the y parameter. 
You can specify x and y in various ways: as 

the octal ASCII code for any character or 
control key; as any printing character in 
double quotes (" "); as the word "control" 
followed by the printing representation of a 
control character in double quotation marks 
(for example, CONTROL "A"); and as the word 
"space" to specify the space bar. If you 
specify x and y to be the same, or if you 
omit y, you get a toggle effect. You can 
specify CTRL/S and CTRL/Q as x and y 
parameters, respectively, only on local 

terminals. (Network terminal connections do 
not allow for CTRL/S and CTRL/Q.) But even 
some local terminals require that you select 
characters other than CTRL/S and CTRL/Q, for 
example, the VT125 and the VT100 with the 
printer port option. 

The default values for x and y are CTRL/S and 
CTRL/Q for local terminals, and CTRL/A/CTRL/A 
for network terminals. You can achieve 

consistency between local and network 

terminals by placing the same TERMINAL PAUSE 
CHARACTER command in your LOGIN.CMD files on 
the various TOPS-20 systems. 

To set the page length, use the TERMINAL 
LENGTH command. If you set the page length 
to 0, the system stops sending output only 
when you type CTRL/S or the x parameter of 
the CHARACTER argument. 

Default - COMMAND (for all terminal 

types) 

- END-OF-PAGE (for display 

terminals, for 
example, VT05, 
VT5 0 , VT5 2 , 

VT100) 

D - CHARACTER (for all terminal 

types) 
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TERMINAL Command Arguments (Cont.) 

RAISE instructs the system to interpret all 

lowercase terminal input as the corresponding 
uppercase characters 

Default 

SPEED nl n2 sets the baud rate at which the TOPS-20 

monitor receives characters from your 
terminal (nl) and sends characters to your 


terminal (n2) . 

Be 

sure also 

to set any 

corresponding switch 

physically 

located on 

your terminal. 




Default nl 

- 300 



n2 

- nl 




SYSTEM-DEFAULT informs the system that your terminal has 

these characteristics (ensuring an acceptable 
minimum level of performance for all terminal 
types) : 

does not have a formfeed or tab 
mechanism 

prints lowercase letters 

needs extra time to perform a carriage 
return, linefeed, tab, and formfeed 

has a line width of 72 

has a page length of 66 

Default for terminal type 

TABS informs the system that your terminal has 

mechanical tab stops every eight columns. 
Otherwise, the system simulates the tabs by 
printing the correct number of spaces. 

TERMINET informs the system that your terminal is a 

TERMINET , which 

does not have a formfeed or tab 
mechanism 

prints lowercase letters 

needs extra time to perform a 
carriage return, linefeed, tab and 
formfeed 

has a line width of 72 
has a page length of 66 

TI informs the system that your terminal is 

a Texas Instruments terminal, which has 
the same characteristics as an EXECUPORT 
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TERMINAL Command Arguments (Cont.) 


TYPE n instructs the system to treat your 

terminal as terminal type n, in 
accordance with the table below: 


Terminal 

Type Characteristics 

0 Model 33 

1 Model 35 

2 Model 37 

3 EXECUPORT and TI 

4-7 reserved for customer use 

8 TERMINET 

9 IDEAL (has a TAB and FORMFEED 

mechanism, prints lowercase, 
has infinite line width and 
infinite page lenath) 

10 VTO 5 

11 VT50 

12 LA3 0 

13 VT52, except for not having 
tabs, and having a page length 
of 30; used for a Digital 
Equipment Corporation GT40. 

14 LA 3 6 

15 VT5 2 

16 VT100 

17 LA 3 8 

18 LAI 20 

19-34 reserved for customer use 

35 VT125 

36 VK100 

Default - 8 

VK100 informs the system that your terminal is 

a Digital Equipment Corporation VK100 
with the same characteristics as the 
VT5 2 and VT100, plus graphics capability 
(both black-and-white and color) . 

VTO 5 informs the system that your terminal is 

a Digital Equipment Corporation VT05, 
which 

does not have a formfeed mechanism 
has a tab mechanism 

prints lowercase letters as uppercase 

needs extra time to perform a linefeed 
or formfeed 

has a line width of 72 
has a page length of 20 
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TERMINAL Command Arguments (Cont.) 


VT5 0 


VT5 2 


VT100 


VT12 5 


WIDTH n 


informs the system that your terminal is a 
Digital Equipment Corporation VT50, which 

does not have a formfeed mechanism 


prints lowercase letters as uppercase 

has a line width of 80 

has a page length of 12 

informs the system that your terminal is a 
Digital Equipment Corporation VT52. The 
system assumes the same characteristics as 
for a VT50 except that it prints lowercase 
letters, and has a page length of 24 lines 
instead of 12. 


informs the system 
Digital Equipment 
system assumes the 
for a VT5 2 . 


that your terminal is a 
Corporation VT100. The 
same characteristics as 


informs the system that your terminal is a 
Digital Equipment Corporation VT125, which 
has full compatibility with the VT100 and the 
capability of business, laboratory, and 
scientific graphics in black and white or 
color . 


tells the system the width, in number of 
characters, of your terminal line. When the 
system prints a line longer than your 
terminal width, it prints the first n 
positions and advances a line to print the 
r est . 

Default Width - 72 


Characteristics 

TERMINAL Commands Before Log-in 

You can use TERMINAL commands, after an initial CTRL/C or 
carriage return but before logging in, to adjust your 
terminal's characteristics. 


Hints 


Setting Your Terminal's Speed 

If the initial speed setting of your terminal line is not 
what you want but your terminal will function at that speed, 
you can give a TERMINAL SPEED command even before log-in to 
set the proper value. If your terminal will not work at the 
initial speed, ask the operator to set an appropriate value. 
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Using Split Speeds 

If you have a terminal that allows split speeds, you can set 
the input and output speeds to different values. This will 
allow you to take advantage of fast system response, for 
example, without providing a needlessly fast input line. A 
setting of 150 2400 will accomplish this. Note that you 
cannot use split speeds on a terminal that is part of a 
DECSYSTEM-2020 system. Note also that using split speeds on 
VT100, VT125, or VK100 terminals may cause the "smooth 
scrolling" feature to function improperly. Refer to the 
appropriate terminal manual, for example, the VT100 User's 
Guide, for details. 


Special Cases 

Terminal Types and Defaults Peculiar to Your System 

The preceding pages describe terminal types and system 
defaults as they are shipped with TOPS-20. However, by 
making changes to the monitor and the TOPS-20 command 
processor, your installation can add different terminal 
types and change the default characteristics associated with 
terminals. Check with your system manager to find out what 
changes, if any, are in effect for your system. 

Terminal Speed Retained from Last Session 

Although most terminal characteristics revert to default 
settings when you log in, the terminal line will retain the 
value for speed set by the last user of the line, even if he 
was using a different kind of terminal. However, if the 
system failed and was restarted after the terminal line was 
last used, the initial speed will be determined by the 
appropriate TERMINAL SPEED command in the system 
configuration file. Also, dial-up lines return to the speed 
specified in this file after every use. 


Warning 


Setting an Improper Terminal Speed 

If you set an incorrect speed for your terminal, e.g., one 
that is too high, you will be unable to use it further. A 
TERMINAL SPEED command in the LOGIN.CMD file in your log-in 
directory can cause the same problem. In such a case, 
obtain your terminal line number if possible (the second 
column of SYSTAT command output consists of line numbers) 
and ask the operator to set an appropriate value. 


Effect on Memory and Terminal 


The TERMINAL command does not affect memory and leaves your 
terminal at TOPS-20 command level. 
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Related Commands 


INFORMATION TERMINAL-MODE for examining your current terminal 

settings 


Examples 


1. Declare that your terminal is an LA36. 

B TERMINAL Lft36 
@ 

2. Do the same thing, using the corresponding numerical type. 

B TERMINAL TYPE 14 
B 

3. Prepare your LA36 terminal for you to type in some upper- and 
lowercase text files on narrow paper. 

B TERMINAL LA3B 
B TERMINAL NO RAISE 
B terminal width 72 
S 


4. Find out your terminal's characteristics, then give the 
command that causes it to print a full page of blank lines 
when you type a CTRL/L (or when it encounters an ~L in a file 
it is printing on your terminal) . 

B I NFQRMAT I ON TERM I N AL - MODE 
TERMINAL LA3B 
TERMINAL SPEED 300 
RECEIVE LINKS 
REFUSE ADVICE 
RECEIVE SYSTEM-MESSAGES 
TERMINAL PAUSE (ON) COMMAND 
TERMINAL NO PAUSE (ON) END-OF-PAGE 
TERMINAL LENGTH GG 
TERMINAL WIDTH 132 
TERMINAL LOWERCASE 
TERMINAL RAISE 
TERMINAL NO FLAG 
TERMINAL INDICATE 
TERMINAL NO FORMFEED 
TERMINAL NO TABS 
TERMINAL NO IMMEDIATE 
TERMINAL FULLDUPLEX 
B TERMINAL NO INDICATE 
B 
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Function 


The TRANSLATE command prints the project-programmer number 
corresponding to a directory name, or the directory name 
corresponding to a project-programmer number. 


Format 


0TRANSLATE (DIRECTORY) dev : <d i rector y> 

or 

@TRANSLATE (DIRECTORY) dev : [pr o j ec t-pr ogr ammer number] 

where 

dev : <directory> is the name of the directory, 

enclosed in angle brackets, 
that you want translated 
Default dev: - your 

connected 

structure 

dev: [project-programmer number] is the project-programmer 

number, enclosed in square 
brackets, that you want 
translated 

Default dev: - your 

connected 

structure 

Hints 


Using Project-programmer Numbers 

Use project-programmer numbers instead of directory names 
when giving file specifications to programs written for the 
TOPS-IO operating system. These include the assembler 
MACRO; the FORTRAN, COBOL, and ALGOL compilers; the 
linking loader LINK; and utility programs CREF (providing 
cross-reference information) and FILCOM (for comparing 
files). If you are unsure whether a system program requires 
project-programmer numbers, load it into memory (using the R 
command), give a CTRL/C to return to TOPS-20 command level, 
and then examine memory with the INFORMATION MEMORY-USAGE 
command. If the file PA1050.EXE (the TOPS-IO compatibility 
package) is present in memory, then the program was 
originally written for TOPS-IO and may require a 
project-programmer number where you would ordinarily give a 
directory name. 
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TRANSLATE (Cont.) 


Avoiding Project-programmer Numbers 

To avoid project-programmer numbers, define a logical name 
(of 6 or fewer characters) as the directory in question. 
Then use this logical name in place of the directory when 
giving file specifications. The system program will accept 
the logical name as a device name, and will then be using 
the correct directory. 


Effect on Memory and Terminal 


The TRANSLATE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


DEFINE for defining a logical name as a directory, to avoid 

using a project-programmer number 


Examples 

1. Find out the project-programmer number associated with your 
connected directory. 

B TRANSLATE < L A T T A > 

P S : < L A T T A > (IS) PS:[4»2GU 
B 

2. Verify that the project-programmer number reported in Example 
1 does correspond to your directory on PS:. 

B TRANSLATE PS: [4 >ZG1 ] 

PS : L A »2G 1 I (IS) PS:<LATTA> 

B 
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TYPE 


Function 


The TYPE command prints the contents of one or more files on your 
terminal . 


Format 


@TYPE (FILE) filespec,... 
where 

filespec is the specification of the file you want to print 

on your terminal 

'••• means that, after commas, you can give more file 

specifications 


Output 


Entire Contents of Files 

In response to the TYPE command the system prints the entire 
contents of a file (up to the EOF (end-of-f ile) pointer) , 
including blank lines and line numbers if there are any. If 
you specify more than one file, the filespec precedes the 
contents of each file. 


Hints 


Stopping TYPE Output 

To stop the TYPE command, type two CTRL/Cs. A CTRL/O will 
also stop the output, but will not stop the processing of 
the command or the accumulation of CPU charges. Note that a 
pair of CTRL/Os causes the system to skip over part of the 
output and continue printing. 


Effect on Memory and Terminal 


The TYPE command does not affect memory and leaves your terminal 
at TOPS-20 command level. 


Related Commands 


for copying files to any device 

for examining specific parts of a file 

for printing files on the line printer 


COPY 

EDIT 

PRINT 
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Examples 

1. Have the system print a file on your terminal. 

@ TYPE TEST .TXT 
! This is file TEST.TXT ! 

@ 
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UNATTACH 


Function 


The UNATTACH command, given at one terminal, disengages another 
job from its terminal. 


Format 


@ UNATTACH (USER) name (JOB #) number 
PASSWORD: password 


is the user name of the job's owner 
is the job number 

Default number — the only job, or only job 
besides your current 

(attached) job, logged in 
under the user name you give 

is the associated password (not requested if you are 
currently logged in under the same user name as the 
job that you are disengaging) 


where 

name 

number 

password 


Characteristics 


Log-in Not Necessary 

You do not have to 
command . 


be logged 


in to give the UNATTACH 


Hints 


Freeing Hung Terminals 


The UNATTACH command is useful for freeing a terminal 
because of program or hardware errors, is no longer 
control of the user. The command UNATTACH n can be 
effective than LOGOUT n for this purpose. 


that , 
under 
more 


Effect on Memory and Terminal 


The UNATTACH command does not affect 
terminal at TOPS-20 command level, 
current state (usually suspended) and 
in the state before log— in. 


memory and leaves your 
The other job is left in 
the disengaged terminal 


own 

its 

is 
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UNATTACH (Cont.) 


Related Commands 


ADVISE for sending commands to another job 

ATTACH for joining another job to your terminal 

DETACH for disengaging your own job from its terminal 


Examples 


1. Disengage another user's job from its terminal. 

B UN ATTACH KftNE 

P a s s w o r d : 

B 

2. From a terminal on which you have not yet logged in, give the 
UNATTACH command to disengage your only logged-in job from 
its terminal. 

SYSTEM 2102 DEVELOPMENT SYSTEM , T0PS-20 Monitor 4(3212) 
B UNATTACH LATTA 

P a s s w o r d : 

B 

3. Give a SYSTAT command to find out what jobs you have running. 
Give the UNATTACH command for two of them (you must specify a 
job number for the first one so the system will know which 
one you mean), and check them with another SYSTAT command. 

BSY5TAT LATTA 


28 

2G 

EXEC 

LATTA 

36* 

230 

EXEC 

LATTA 

40 

27 

EXEC 

LATTA 


B UNATTACH LATTA 28 
[Attached to T T Y 2 6 » confirm] 
B UNATTACH LATTA 
BSYSTAT LATTA 


28 

DET 

EXEC 

LATTA 

3G* 

230 

EXEC 

LATTA 

40 

DET 

EXEC 

LATTA 


B 
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UNDELETE 


Function 


The UNDELETE command restores previously-deleted files. 


Format 


@ UNDELETE filespec,... 

where 

filespec is the specification of the file you want to restore 

Default .gen - all generations of the specified 
files 

»••• means that, after commas, you can give more file 

specifications 


Restrictions 


Erasure of Deleted Files 

Ordinarily an UNDELETE command given during the same 
terminal session as an original deletion will recover the 
deleted files, unless you included the EXPUNGE subcommand to 
DELETE or gave a subsequent EXPUNGE command. However, if 
any user or a batch job logs out while connected to your 
directory, all deleted files are permanently erased. Also, 
if available disk space is low on the system, the operator 
or the system itself may expunge all deleted files. A 
system warning message is usually sent before this happens. 


Special Cases 


Restoring Files Deleted With CONTENTS-ONLY Subcommand. 

Any files deleted by a DELETE command with a CONTENTS-ONLY 
subcommand are immediately expunged. You must use the 
RETRIEVE command to restore these to disk. 


Effect on Memory and Terminal 


The UNDELETE command does not affect memory and leaves your 
terminal at TOPS-20 command level. 
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Related Commands 


DELETE 

DIRECTORY-class commands 


EXPUNGE 


RETRIEVE 


Examples 


1. Undelete a file. 

B UNDELETE TEST . FIL 
TEST . F I L . 1 [OKI 
TEST . F I L . 2 C0K3 

0 

2. Access another user's directory, then restore all his deleted 
files of type .FIL. 

B ACCESS < CARSON > 

Password: 

B UNDELETE < CARSON >*. F I L 
< CARSON >MEM0.F I L. 1 [OKI 
< CARSON > SEARCH. FIL» 1 [OKI 
< CARSON > TEST .FIL. 1 [OK] 

< CARSON >UERFY . FIL . 1 [OK] 

B END-ACCESS < CARSON > 

B 


for deleting files 

for obtaining lists of deleted files 
(with DELETED subcommand) 

for permanently erasing deleted 
files 

for restoring off-line files to disk 
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UNLOAD 


Function 


The UNLOAD command rewinds a magnetic tape until it is returned 
completely to the source reel, and puts the associated tape drive 
off line. Use UNLOAD only for tapes mounted on drives having 
device names of the form MTAn : . 


Format 


@ UNLOAD (DEVICE) dev: 
where 

dev: is the name of the magnetic tape drive that you want to 

unload 


Restr ictions 


UNLOAD With Open Files 

If you have given a CTRL/C to exit from' a program that has 
opened a magnetic tape drive and you then gave the UNLOAD 
command for that tape drive, the system will first ask if 
you want to close the associated file. You must do so for 
UNLOAD to succeed, but you will probably be unable to 
continue the program from that point because the file will 
now be closed. 


Warning 


Cannot Access Tape Again 

The UNLOAD command makes it impossible to access your tape 
again unless it is reloaded by the operator. 


Effect on Memory and Terminal 


The UNLOAD command does not affect memory and leaves your 
terminal at TOPS-20 command level. 


Related Commands 


DISMOUNT for unloading tapes mounted on devices of the form 
MTn : 


REWIND 


for rewinding a magnetic tape volume or tape set to 
its load point (logical beginning) 
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Examples 


1. Unload your magnetic tape from drive MTAO : . 

@ UNLD AD MTftQ : 

@ 
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VDIRECTORY 


Function 


The VDIRECTORY (Verbose DIRECTORY) command is equivalent to the 
DIRECTORY command with the subcommands LENGTH, NO HEADING, 
PROTECTION, SIZE, and TIMES (AND DATES OF) WRITE. Use the same 
format and subcommands with VDIRECTORY as with DIRECTORY. For 
further information see the DIRECTORY command description in this 
manual . 

When used with magnetic tapes, the VDIRECTORY command is 
equivalent to the DIRECTORY command for magnetic tapes. 


Examples 


1. Give the VDIRECTORY command, then cut off the output with a 
CTRL/C. 


B UD I RECTORY 

M I SC : < LATTA > 
4-UPED.TXT. 14 5P777700 

A. DIRECTORY. 1 5P20200 
ART I F I . C T L . 7 i P 7 7 7 7 0 0 

B. DIRECTORY. 1 5PZ0200 

C. EXE. 1 5 P 7 7 7 7 0 0 
CONFAB. CTL. 1 5P777700 
DIVIDE. FOR. 4 5P777700 
DUMPER. MAC. 1 5P777700 
MAGNIF , CTL , 2 i P777700 

@ 


0 0(7) 

1 0 ( 0 ) 

1 215(7) 

1 0 ( 0 ) 

3 1 53S ( 3G ) 

1 115(7) 

1 260(7) 

53 134442(7) 
1 "C 


25-Ap r-79 
2-May -79 
24- Ap r-79 
9-May -79 
13-Ap r-78 
3 - M a y - 7 8 
8-Ma r-79 
8 - N o i.i - 7 8 


09 : 58 : 2 1 
13: 14:52 
10:1 0 : 1 0 
12:54:00 
04 : 27 : 59 
13:34:37 
15:47:41 
10:47:04 


2. Ask for a VDIRECTORY listing of certain files; include a 
line of headings. 

B OD I RECTORY TEST*. FOR > 

BB HEADING 

BB 


PGS Bytes (SZ) 


M ISC: < LATTA > 

TESTF1 ,F0R,8iP777700 1115(7) 

TESTF2.F0R. 1 5 P 7 7 7 7 0 0 1 115(7) 

TESTF3.F0R. 1 i P777700 1115(7) 

Total of 3 paSes in 3 files 
B 


Write 


25-Ap r-79 
20 -Apr-79 
20 -Apr-79 


09 : 44 : 50 
10:01:56 
10 : 02: 19 
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APPENDIX A 


FUNCTIONAL GROUPING OF TOPS-20 COMMANDS 


This appendix lists and briefly explains all non-pr ivileged commands 
in the TOPS-20 command language, grouping them in categories of 
similar use. 


A . 1 SYSTEM ACCESS COMMANDS 


These commands allow you to gain and relinquish access to the system, 
to activate and deactivate any special capabilities you have been 
given, and to disengage and engage jobs to your terminal. 


ATTACH 

DETACH 

DISABLE 

ENABLE 

LOGIN 

LOGOUT 

UNATTACH 


Engages a designated job to your terminal. 

Disengages your current job from your terminal. 

Deactivates any special capabilities you have been 
granted . 

Activates any special capabilities you have been 
granted . 

Gains access to the TOPS-20 system. 

Relinquishes access to the TOPS-20 system. 
Disengages another job from its terminal. 


A. 2 FILE SYSTEM COMMANDS 


The file system commands allow you to create, examine, change, and 
delete files. 

ACCESS Obtains ownership rights to the specified 

directory, as well as the group rights of the 
directory's owner. 

APPEND Adds contents of one or more files to another 

file . 


ARCHIVE Makes a permanent off-line copy of files. 

BUILD Creates, modifies, or deletes a subdirectory. 

CLOSE Closes files left open by a program, and releases 

unopened JFNs. 
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CONNECT 

COPY 

CREATE 

DEFINE 

DELETE 

DIRECTORY 

DISCARD 

EDIT 

END-ACCESS 

EXPUNGE 

FDIRECTORY 

RENAME 

RETRIEVE 

TDIRECTORY 

TYPE 

UNDELETE 

VDIRECTORY 


Connects you to the specified directory. 

Duplicates files. 

Starts the EDIT program to make a new file. 

Associates a logical name with one or more 
f ilespecs. 

Marks files for eventual erasure (disk files 
only) , or erases the files (all other devices) . 

Gives information about the files in a directory. 

Gives up the tape copy of specified on-line files. 

Starts the EDIT program to change an existing 
f ile . 

Relinquishes ownership rights to the specified 
directory. 

Permanently erases any deleted files. 

Lists all the information about files. 

Changes one or more parts of an existing file 
specification . 

Restores off-line files to disk. 

Lists the names and write dates of files in the 
order of the date and time they were last changed. 

Prints files on your terminal. 

Restores files marked for erasure. 

Lists the names of files, as well as their 
protection, size, and the date and time they were 
last changed. 


A. 3 DEVICE-HANDLING COMMANDS 


These commands 
manipulate the 

ASSIGN 

BACKSPACE 

DEASSIGN 

DISMOUNT 


EOF 

MOUNT 


REWIND 


allow you to reserve a device prior to using it, to 
device, and to release it once it is no longer needed. 

Reserves a device for use by your job. 

Moves a magnetic tape backward. 

Releases a previously assigned device. 

Gives up access to the specified structure or tape 
set . 

Writes an end-of-file mark on a magnetic tape. 

Requests use of the specified structure or tape 
set . 

Moves a magnetic tape backward to its load point. 
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SKIP Moves a magnetic tape forward. 

UNLOAD Rewinds a magnetic tape until the tape is wound 

completely on the source reel. 


A. 4 PROGRAM CONTROL COMMANDS 

The following commands help you run and debug your own programs. 


COMPILE 

Translates a source program using the appropriate 
compiler . 

CONTINUE 

Resumes execution of a program (e.g., one 

interrupted by a CTRL/C) . 

CREF 

Runs the CREF program, which produces a 
cross-reference listing and automatically sends it 
to the line printer. 

CSAVE 

Saves in a compressed executable format the 
program currently in memory. (Usually SAVE is 
better for most purposes.) 

DDT 

Merges the loaded debugging program (or if none, 
DDT) with the current program and then starts the 
debugging program. 

DEBUG 

Compiles a source program, loads it with a 

compatible debugging program, and starts the 

debugging program. 

DEPOSIT 

Sets the contents of the specified memory 

location. 

EXAMINE 

Checks the contents of the specified memory 

location . 

EXECUTE 

Compiles, loads, and begins execution of a 

program . 

FORK 

Makes some TOPS-20 commands apply to the specified 
process . 

GET 

Places an executable program in memory. 

LOAD 

Compiles a program and loads it into memory. 

MERGE 

Places an executable program in memory and merges 
it with the current contents of memory. 

POP 

Finishes a level of TOPS-20 and returns control to 
the previous level of TOPS-20. 

PUSH 

Starts a new level of TOPS-20. 

R 

Runs a system program. 
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REENTER 

Starts the program currently in memory at the 
alternate entry point specified in the program's 
entry vector. 


RESET 

Clears memory for the current process of your job 
and its inferiors. 


RUN 

Places an executable program in memory and starts 
it. 


SAVE 

Copies the contents of memory into a file in 
executable format. 


START 

Begins execution of the program in memory. 

A. 5 

INFORMATION COMMANDS 

These commands 
and the system 

return information about TOPS-20 commands, your job, 
as a whole. 


DAYTIME 

Prints the current date and time of day. 


HELP 

Gives an explanatory message about specific system 
programs . 


INFORMATION Provides information about your job and its use of 

available computing resources, and about the 

system. 


SYSTAT 

Gives a summary of information about current jobs 
on the system. 


TRANSLATE 

Tells you what project-programmer number is 

associated with a directory name, and vice versa. 

A. 6 

TERMINAL 

COMMANDS 

The terminal commands allow you to declare the characteristics of your 
terminal, to clear your video screen, and to control linking to 
another user's terminal. 


ADVISE 

Sends whatever you type on your terminal as input 
to a job engaged to another terminal. 


BLANK 

Clears your display screen and moves the cursor to 
line 1. 


BREAK 

Clears communication links. 


RECEIVE 

Allows your terminal to receive communication 
links, advice, or system messages from other 
users . 


REFUSE 

Denies links, advice, or system messages to your 
terminal . 


REMARK 

Notifies the system that your terminal is not 
sending commands but only comments. 
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SET 

TAKE 


Establishes certain job-wide characteristics for 
your terminal session. 

Executes commands contained in the specified file. 


TALK 


TERMINAL 


Links two terminals so that each user can observe 
what the other user is doing, without affecting 
his job. 

Informs the system of your terminal type, and lets 
you determine the setting of its variable 
parameters . 


A. 7 OUTPUT COMMANDS 

These commands allow you to reguest output listings of files on the 
plotter, line printer, card punch, or paper tape punch, and to 
examine, modify, or withdraw these requests. 

CANCEL Withdraws requests from an output 

queue (waiting list) . 

INFORMATION OUTPUT-REQUESTS Lists entries in the output 

queues . 

Changes entries in an output 
queue . 

Places requests in a plotter 
output queue. 

Places requests in a line printer 
output queue. 

Places requests in a card punch 
or paper tape punch output queue. 


MODIFY 

PLOT 

PRINT 

PUNCH 


A. 8 BATCH COMMANDS 


The TOPS-20 system also has a batch system to which you can submit 


jobs for execution. 

CANCEL BATCH 

INFORMATION BATCH-REQUESTS 

MODIFY BATCH 

SUBMIT 


Withdraws entries from the 
input queue (waiting list). 

batch 

Lists entries in the 
queue . 

batch 

input 

Changes entries in the 
queue . 

batch 

input 

Places a batch control 
batch input queue. 

file 

in the 
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APPENDIX B 


ALPHABETICAL LIST OF TOPS-20 COMMANDS 


This appendix consists of an alphabetical list of TOPS-20 commands and 
short descriptions of each. The varieties of argument needed to 
complete each command are shown next, in the order that you give them; 
parentheses indicate that the argument is optional or can be 
defaulted. Last comes the effect of the command on memory - whether 
it clears memory (by loading a program or by other means) or otherwise 
alters it, or leaves it unaffected. Use this appendix along with the 
question mark and recognition features to refresh your memory once you 
have become familiar with the contents of this manual. 


Command 

Function 

Arguments 

Effect 

on 

Memory 

ACCESS 

gets ownership rights 
to a directory 

dev : <d irectory> , 
password 

— 

ADVISE 

sends commands to 
another user's job 

user name or 
terminal number 

— 

APPEND 

adds files onto end 
of another file 

f ilespecs , 
(subcommands) 

— 

ARCHIVE 

requests off-line 
storage of files 

f ilespecs , 
(subcommand) 

— 

ASSIGN 

allocates a device 
for your job 

device name 

— 

ATTACH 

engages a job to 
your terminal 

user name, 

(job number) 
(password) 


BACKSPACE 

moves a magnetic 
tape backward 

device name, number 
of records or files 

— 

BLANK 

clears your video 
terminal screen 

— 

— 

BREAK 

ends links made by a 
TALK command 

(user name or 
line number) 

— 

BUILD 

creates, modifies, or 
deletes a subdirectory 

dev: <directory> , 
subcommands 

— 

CANCEL 

withdraws output 
or batch requests 

queue, jobname 

— 
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Command 

CLOSE 

COMPILE 

CONNECT 

CONTINUE 

COPY 

CREATE 

CREF 

CSAVE 

DAYTIME 

DDT 


DEASSIGN 

DEBUG 

DEFINE 

DELETE 

DEPOSIT 

DETACH 


Function 

Arguments 

Effect 

on 

Memory 

closes open files 

JFN 

— 

translates source 
programs into object 
programs 

filespecs, switches 

loads 

comiler 

connects your job 
to a directory 

dev:<directory>, 

password 

— 

continues a halted 
program 

NORMALLY or STAY 

— 

makes copies of 
a file 

f ilespec , f ilespec 
(subcommands) 

— 

creates a file 

(switches) , 
f ilespec 

loads 

EDIT 

translates . CRF 
files into listings 

(f ilespec) 

loads 

CREF 

stores a copy of 
memory in a file 
(in compressed format) 

(filespec, memory 
locations) 


tells the date and 
time 

— 

— 

starts a debugging 
program 

(switches) 

merges 

debugging 

program 

with 

existing 
memory (if 
necessary) 

gives up a previously 
assigned device 

device name 

— 

debugs a program 

filespec, switches 

loads 

program 

and 

debugging 

program 

establishes or withdraws 
a logical name 

logical name, 
search list 

— 

marks files for 
later erasure 

filespecs , 

( subcommand s ) 

— 

changes contents of 
a memory location 

memory location, 
octal number 

changes 

one 

location 

disengages a 

(argument) 

— 


job from your 
terminal 
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Command 

DIRECTORY 

DISABLE 

DISCARD 

DISMOUNT 

EDIT 

ENABLE 

END-ACCESS 

EOF 

EXAMINE 

EXECUTE 

EXPUNGE 

FDIRECTORY 

FORK 

GET 

HELP 

INFORMATION 


Function 

Arguments 

gives information 
about files 

(dev:<directory>, 
filespecs) , 
subcommands 

deactivates 

capabilities 

— 

gives up tape copy 
of on-line files 

filespecs 

gives up access to 
structure or tape 
set 

alias or setname, 
switches 

edits existing 
files 

(switches) , 
f ilespec 

activates capabilities 

— 

terminates ownership 
rights to a directory 

dev: <directory> 

writes an 

end-of-file mark on 
a magnetic tape 

device name 

inspects a memory 
location 

memory location 

compiles, loads and 
starts a program 

filespec., switches 

erases all deleted 
files from a 
directory 

(dev : <d i rector y> , 
subcommands) 

DIRECTORY command 
with subcommands 

CRAM, EVERYTHING, 
and NO HEADING 

(dev:<directory>, 
filespecs) , 
subcommands 

specifies what 
process is current 

process number 

places an executable 
program in memory 

filespec , 

(switches) 

presents a short 
description of a 
system program 

name of system 
program 

gives information 
about system and job 
parameters 

arguments 


Effect 

on 

Memory 


loads 

EDIT 


loads 

compiler 

and/or 

program 


loads 

program 


TOPS-20 Version 5 


B-3 


April 1982 



ALPHABETICAL LIST OF TOPS-20 COMMANDS 


Command 

Function 

Arguments 

LOAD 

compiles and loads 
a program 

filespec, switches 

LOGIN 

begins a job 

user name, 
password, account 

LOGOUT 

ends a job 

— 

MERGE 

merges an executable 
program with current 
memory 

filespec , 

(switches) 

MODIFY 

changes output or 
batch requests 

queue, jobname, 
switches 

MOUNT 

requests use of 
structure or tape set 

alias or setname, 
switches 

PLOT 

POP 

plots files on 
plotter 

returns to superior 
TOPS-20 command 
level, ending 
inferior TOPS-20 
command level 

filespecs, switches 

PRINT 

prints files on 
line printer 

filespecs, switches 

PUNCH 

punches files on 
card punch or paper 
tape punch 

filespecs, switches 

PUSH 

begins an inferior 
TOPS-20 command 
level 


R 

runs a system 
program 

name of system 
program, (switches) 

RECEIVE 

allows communication 
with your terminal 

argument 

REENTER 

starts program in 
memory at the 
restart address 

— 

REFUSE 

disallows 

communication with your 
terminal 

argument 

REMARK 

informs the system 
that you are typing 
only comments, not 
commands 



Effect 

on 

Memory 

loads 

compiler 

and/or 

program 


clears 

memory 

adds 

program 

to 

existing 

memory 


clears 
memory of 
inferior 
process 


preserves 

superior 

memory 

loads 

program 
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Command 

RENAME 

RESET 

RETRIEVE 

REWIND 

RUN 

SAVE 

SET 

SKIP 

START 

SUBMIT 

SYSTAT 

TAKE 

TALK 

TDIRECTORY 

TERMINAL 


Function 

changes the 
specification of a 
file 

finishes current 
process and clears 
its memory 

restores off-line 
files to disk 

rewinds a magnetic 
tape to its load 
point 

places an executable 
program in memory 
and starts it 

stores a copy of 
memory in a file 

sets various job 
parameters 

moves a magnetic 
tape forward 


starts program in 
memory at start 
address 

submits entries (jobs) 
to the batch system 

gives information 
about system and job 
status 

starts processing 
of a command file 

makes communication 
links with another 
user 

DIRECTORY command 
with subcommands 
CHRONOLOGICAL WRITE, 
REVERSE, and TIMES 
WRITE 

sets various 

terminal 

characteristics 


Arguments 
filespec, filespec 


f ilespecs 


device name 


filespec , 
(switches) 


(filespec) 


arguments 


device name, 
number of records 
or files 

(memory location) 


filespecs, switches 


arguments , 
(subcommands) 


f ilespec , 
(subcommands) 

user name or 
terminal number 


(dev:<directory>, 
filespecs) , 
subcommands 


argument 


Effect 

on 

Memory 


clears 

memory 


loads 

program 
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Command 

TRANSLATE 

TYPE 

UNATTACH 

UNDELETE 

UNLOAD 

VDIRECTORY 


Function 

gives directory 
names for ppn ' s and 
vice versa 

prints files on your 
terminal 

disengages another job 
from its terminal 


restores deleted 
files 

unloads a magnetic 
tape and deassigns 
the drive 

DIRECTORY command 
with subcommands 
LENGTH, NO HEADING, 
PROTECTION, SIZE, 
and TIMES WRITE 


Arguments 

dev: <directory> or 
[project-programmer 
number ] 

f ilespecs 


user name, 
(job number) 
(password) 

f ilespec 


device name 


(dev:<directory>, 
filespecs) , 
subcommands 


Effect 

on 

Memory 
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APPENDIX C 


FILE ATTRIBUTES 


This appendix lists the attributes that you can include in a file 
specification. The DECnet-r elated attributes are described in detail 
in the DECnet documentation. Information on file attributes is also 
contained in the TQPS-20 User's Guide , the TQPS-20 Monitor Calls 
Reference Manual , and the TQPS-20 Tape Processing Manual . 

;A:account System manager defined account string 

;BDATA:user data DECnet optional binary data 

; BLOCK-LENGTH : n Maximum size of a magnetic tape block 

(meaningful to programs that perform tape 
input and output, such as DUMPER) 

;BPASSWORD:password DECnet binary password 

;CHARGE :account DECnet account string 

; DATA : user data DECnet optional data 

; EXPIRATION-DATE :date Date the magnetic tape file can be 

overwritten 

; FORMAT: F ,D , S , or U Magnetic tape record format: 

F=f ixed- length 
D=var i able- length 
S=spanned 
U=undef ined 

; OFF-LINE Designation for a file that is off line 

because of migration or archiving 

;P:n File protection value 

; PASSWORD: password DECnet password 

; POSITION : n File sequence number for magnetic tape 

positioning 

; RECORD-LENGTH : n Maximum size of a magnetic tape record 

;T Designation for a file that is to be deleted 

at log-out time (a temporary file) 

;USERID:id DECnet user ID string 
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FILE ATTRIBUTES 


Note that you can issue TOPS-20 commands as an alternative to 
specifying many of the file attributes. For example, SET FILE 
PROTECTION, rather than the P attribute, can be used to set the file 
protection. Also, such commands as INFORMATION FILE-STATUS and 
DIRECTORY (with the EVERYTHING subcommand) display your file attribute 
settings . 
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TOPS-20 

Commands Reference Manual 
AD-51 15B-T1 


READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will use comments submitted on 
this form at the company's discretion. If you require a written reply and are eligible to 
receive one under Software Performance Report (SPR) service, submit your com- 
ments on an SPR form. 

Did you find this manual understandable, usable, and well-organized? Please make sugges- 
tions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of reader that you most nearly represent. 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Other (please specify) 

Name Date 

Organization Telephone 

Street 

City State Zip Code _ 

or Country 





Do Not Tear — Fold Here and Tape 







INDEX 


$ character, 2-70, 2-93, 
2-128 

$ prompt, 2-114, 2-132 


% 

character , 

1-2, 2-70, 


2-128 


1 

character , 

2-317 

* 

character , 

1-2 

- 

character , 

2-93 

. 

character , 

2-70, 2-128 

/ 

character , 

1-2 


0 , 

fork, 2-150 

page length, 2-319 


128-character alphabet, 
2-69, 2-126 


33, 

Teletype Model, 2-317 


33 argument, 2-316 


35 ' 

Teletype Model, 2-317 


35 argument, 2-316 


37, 

Teletype Model, 2-317 


37 argument, 2-317 


64-character alphabet, 2-69, 
2-126 

/68-COBOL switch, 2-48, 

2-86, 2-141, 2-172 


7-TRACK argument, 2-200 


/74-COBOL switch, 2-48, 
2-86, 2-141, 2-172 


9-TRACK argument, 2-200 


? character, 1-6 
@ character, 2-114, 2-179 


@ prompt, 2-114, 2-132, 
2-179 


; A attribute, 2-64, 2-255 
Abbreviated error messages, 
2-70, 2-127 

Abbreviating argument, 1-5 
Abbreviation , 

non-unique, 1-6 
Abnormal termination of 
program, 2-45 
ABORT subcommand, 2-27 
Accepting terminal input 
after error, 2-275 
Access , 

append, 2-160 
execute, 2-160 
mode of, 2-160 
read, 2-160 

write, 2-26, 2-32, 2-160 
ACCESS command, 2-1, 2-53 
Access condition, 
special, 2-160 
Access of page, 

preventing write, 2-276 
specifying execute, 2-276 
specifying read, 2-276 
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(CONT. ) 


Access of page (Cont.) 

specifying write, 2-276 
Access rights for batch job, 
2-295 

Access to directory, 
read, 2-295 
write, 2-295 

Access with LOGIN command, 
implicit, 2-1 
Accessed directory, 2-241 
Accessing magnetic tape 
again, 2-334 

Accessing open file, 2-83 
Account , 

default, 2-159 
printing, 2-161 
specifying, 2-179, 2-271, 
2-273 

specifying default, 2-272 
specifying new, 2-255 
ACCOUNT argument, 2-271, 
2-273 

ACCOUNT command , 

SET, 2-54 

Account for batch job, 
specifying, 2-289 
Account for file, 

printing, 2-107, 2-112 
specifying, 2-64, 2-273 
Account for files, 

specifying, 2-217, 2-235 
Account for printing job, 
specifying, 2-227 
ACCOUNT subcommand, 2-107 
/ACCOUNT switch, 2-217, 
2-227, 2-235, 2-289 
Account validation, 2-167 
ACCOUNT-DEFAULT argument, 
DIRECTORY, 2-272 
ACCOUNT-DEFAULT subcommand, 
2-27 

Accounting, 2-167 
system, 2-54 

Accumulated CPU time of job, 
finding out, 2-301 
Accumulated runtime of job, 
finding out, 2-301 
Activating capabilities, 
2-132 

Address break, 2-157 
canceling, 2-271 
specifying, 2-271 
Address space, 2-56 
ADDRESS-BREAK argument, 

2-157, 2-271 
ADDRESS-BREAK command, 
INFORMATION, 2-271 
Advice, 2-168 

implicit refusal of, 


Advice (Cont . ) 

2-251 

receiving, 2-246 
refusing, 2-250 
ADVICE argument, 2-246, 


2-250 


ADVISE command, 2-4, 

2-251, 

2-252 


Advising another job, 
Advising PTY : , 2-5 
After error. 

2-4 

accepting terminal 

input , 


2-275 


disregarding terminal 
input, 2-274 
After printing, 

deleting file, 2-229 
saving file, 2-230 
AFTER subcommand, 2-271 
/AFTER switch, 1-2, 2-164, 
2-190, 2-217, 2-227, 
2-235, 2-289 
.ALG, 

file type, 2-50, 2-88, 
2-143, 2-174 

/ALGOL switch, 2-48, 2-86, 
2-141, 2-172 
Alias, 2-119, 2-203 
ALL argument, 2-161 
ALL subcommand, 2-271, 

2-300 

/ALL switch, 2-158, 2-163, 
2-164, 2-165 
Allocating device, 2-17 
Alloted to and used by each 
job, 

finding out CPU 

percentages, 2-30(7 
ALLOW subcommand, 2-307 
Allowing migration of file, 
2-274 
Alphabet , 

128-character, 2-69, 

2-126 

64-character, 2-69, 2-126 
Alphabetical list of files, 
printing, 2-107 
ALPHABETICALLY subcommand, 
2-107 

Alternate entry point of 
program, 2-248 
ALWAYS argument, 2-291 
Angle brackets, 1-2, 1-4 
ANSI argument, 2-200 
ANSI-ASCII argument, 2-278 
ANSI-ASCII format, 2-167 
Append access, 2-160 
APPEND argument, 2-290 
APPEND command, 2-8 
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APPEND command subcommands, 
2-8 

Appending files, 2-8 
Appending from TTY:, 2-10 
Archival request, 
canceling, 2-38 
ARCHIVE argument, 2-38 
ARCHIVE command, 2-13 
ARCHIVE command subcommands, 
2-13 

Archive status of file, 

2-157 

withdrawing, 2-116 
ARCHIVE subcommand, 2-94 
Archive tape, 

volids of, 2-166 
ARCHIVE-STATUS argument, 
2-157 

Archived file, 2-13 
deleting, 2-94 
expunging, 2-94 
recovering deleted, 2-96 
renaming, 2-255 
Archived files, 
copying, 2-64 
editing, 2-129 
printing list of, 2-107 
ARCHIVED subcommand, 2-107 
Argument , 

33, 2-316 
35, 2-316 
37, 2-317 
7-TRACK, 2-200 
9-TRACK, 2-200 
abbreviating, 1-5 
ACCOUNT, 2-271, 2-273 
ADDRESS-BREAK, 2-157, 
2-271 

ADVICE, 2-246, 2-250 
ALL, 2-161 
ALWAYS, 2-291 
ANSI, 2-200 
ANSI-ASCII, 2-278 
APPEND, 2-290 
ARCHIVE, 2-38 
ARCHIVE-STATUS, 2-157 
ARPANET, 2-158 
ARROW, 2-193, 2-230 
ASCII, 2-192, 2-193, 

2-220, 2-229, 2-230, 
2-237 

AVAILABLE, 2-158, 2-181 
AVAILABLE DEVICES, 2-158 
AVAILABLE LINES, 2-158 
BATCH, 2-188 
BATCH-REQUESTS, 2-158 
BCD, 2-193, 2-237 
BINARY, 2-193, 2-220, 
2-237 


Argument (Cont.) 

BY-PAGES, 2-107 
BYPASS, 2-200 
CARD-READER-INPUT-SET , 

2-272 

CARDS, 2-38, 2-188, 2-233, 
2-272 

COBOL, 2-192 
COMMAND, 2-320 
COMMAND-LEVEL, 2-159, 

2-181 

COMPILE-SWITCHES, 2-272 
CONTINUE, 2-102 
CONTROL-C-CAPABILITY , 

2-272 

CONTROLLING, 2-301 
COPY-ON-WRITE, 2-276 
CORE-DUMP, 2-278 
CREATED, 2-110 
CREATION, 2-107, 2-110 
DECNET NODES, 2-159 
DEFAULT, 2-272 
DEFERRED, 2-277 
DETACHED, 2-300 
DEVICES, 2-158 
DIRECTORY, 2-159, 2-272, 

2-301 

DIRECTORY ACCOUNT-DEFAULT, 
2-272 
DIRECTORY 

FILE-PROTECTION-DEFAULT, 

2-272 

DIRECTORY PASSWORD, 2-273 
DIRECTORY PROTECTION, 

2-273 

DISK-USAGE, 2-160 
DOUBLE, 2-230 
EBCDIC, 2-200 
ELEVEN, 2-192, 2-229 
END-OF-PAGE, 2-320 
ENTRY -VECTOR, 2-273 
ERRORS, 2-291 
EVEN, 2-278 
EXECUPORT, 2-317 
EXECUTE, 2-276 
FILE, 2-273 
FILE-STATUS, 2-160 
FILES, 2-283 
FLAG, 2-317 
FORMFEED, 2-317 
FORTRAN, 2-192, 2-229 
FULLDUPLEX, 2-317 

GENERATION-RETENTION-COUNT , 
2-274 

HALFDUPLEX, 2-317 
HEADER, 2-301 
HELP, 2-317 
HIGH-DENSITY, 2-278 
IMAGE, 2-193, 2-220, 
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Argument (Cont . ) 

2-237 

IMAGE-BINARY, 2-193, 

2-237 

IMMEDIATE, 2-277 , 2-317 
INDICATE, 2-318 
INDUSTRY-COMPATIBLE , 

2-278 

INVISIBLE, 2-274 
JOB, 2-161 
JOB-STATUS, 2-161 
jobname, 2-39 
LA120, 2-318 
LA3 0 , 2-318 
LA36 , 2-318 
LA38 , 2-318 
LATE-CLEAR-TYPEAHEAD , 
2-274 

LENGTH, 2-319 
LEOT, 2-283 
LIMIT, 2-301 
LINE-HALFDUPLEX, 2-319 
LINES, 2-158 
LINKS, 2-246, 2-250 
LOCATION, 2-275 
LOGICAL-NAMES, 2-161 
LOWERCASE, 2-319 
MAIL, 2-161, 2-181 
medium, 2-121, 2-199 
MEMORY-USAGE, 2-161 
MONITOR-STATISTICS, 2-162 
MOUNT, 2-38 
MOUNT-REQUESTS, 2-163 
NO, 2-292, 2-319 
NO CONTROL-C -CAPABILITY , 
2-275 

NO COPY-ON-WRITE, 2-276 
NO DEFAULT, 2-275 
NO LATE-CLEAR-TYPEAHEAD, 
2-275 

NO MAIL-WATCH, 2-276 
NO PROHIBIT, 2-274 
NO TIME-LIMIT, 2-276 
NO UUO-S IMULATION , 2-276 
NO WRITE, 2-276 
NOLOG, 2-291 
NONEXISTENT, 2-276 
NOPARITY, 2-9, 2-62 
NORMALLY, 2-56 
NUMBER, 2-203 
OCTAL, 2-193, 2-230 
ODD, 2-278 

OPERATOR, 2-301, 2-304 
OUTPUT-REQUESTS, 2-164 
PAGE, 2-319 
PAGE-ACCESS, 2-276 
PAPER-TAPE, 2-38, 2-188, 
2-233, 2-272 
PARITY, 2-9, 2-62 


Argument (Cont . ) 

PAUSE, 2-320 

PLOT, 2-38, 2-188, 2-272 
PRINT, 2-188, 2-272, 

2-275 

PROGRAM-STATUS, 2-165 
PROHIBIT, 2-274 
PROTECTION, 2-274 
PSI-STATUS, 2-165 
RAISE, 2-320 

READ, 2-107, 2-110, 2-276 
recognizing, 1-5 
RECORDS, 2-283 
REENTER, 2-102 
reguest ID, 2-38, 2-188 
RETRIEVAL-REQUESTS, 2-165 
RETRIEVAL-WAIT, 2-277 
RETRIEVE, 2-38 
SEQUENTIALLY, 2-107 
SESSION-REMARK, 2-277 
SINGLE, 2-230 
SIXBIT, 2-278 
SPEED, 2-320 
SPOOL, 2-290 
SPOOLED -OUTPUT -ACT I ON , 
2-166, 2-277 
START, 2-102, 2-203 
STATE, 2-301 
STAY, 2-56 

STRUCTURE, 2-119, 2-166, 
2-199 

SUBMIT, 2-272, 2-275 
SUBSYSTEM-STATISTICS , 
2-167 

SUPERSEDE, 2-290 
SUPPRESS, 2-193, 2-230 
SYSTEM, 2-161, 2-301 
SYSTEM-DEFAULT, 2-277, 
2-320 

SYSTEM-MESSAGES, 2-246, 
2-250 

SYSTEM-STATUS, 2-167 
TABS, 2-320 
TAKE, 2-272 

TAPE, 2-119, 2-199, 2-277 
TAPE DENSITY, 2-277 
TAPE FORMAT, 2-278 
TAPE PARITY, 2-278 
TAPE RECORD-LENGTH, 2-278 
TAPE-PARAMETERS, 2-167 
TAPE-WRITE, 2-107, 2-110 
TERMINAL-MODE, 2-168, 

2-181 

TERMINET , 2-321 
TI, 2-321 
TIME, 2-301 
TIME-LIMIT, 2-278 
TOPS-20 , 2-200 
TRIPLE, 2-230 
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Argument (Cont . ) 

TYPE, 2-321 

UNLABELED, 2-200 

UUO-S IMULATION , 2-279 

VERSION, 2-168, 2-181 

VISIBLE, 2-274 

VOLUMES, 2-168 

VT05 , 2-322 

VT100 , 2-322 

VT50 , 2-322 

VT52 , 2-322 

WHAT, 2-301 

WHERE, 2-301 

WHO, 2-301 

WIDTH, 2-322 

WRITE, 2-107, 2-110, 

2-276 

WROTE, 2-110 
YES, 2-292 
Arguments, 1-1, 1-4 
Arguments , 

CONTINUE command, 2-56 
default, 1-4 
DETACH command, 2-102 
HELP command, 2-154 
INFORMATION command, 

2-156 

LOGIN command, 2-179 
MODIFY command, 2-188 
RECEIVE command, 2-246 
REFUSE command, 2-250 
SET command, 2-269 
TERMINAL command, 2-315 
Arguments for mounting tape, 
dummy dev: , 2-206 
ARPA network, 2-27, 2-158 
ARPANET argument, 2-158 
ARPANET-WIZARD subcommand, 
2-27 

Array dimension checking, 
2-89 

ARROW argument, 2-193, 

2-230 

ASCII argument, 2-192, 

2-193, 2-220, 2-229, 
2-230, 2-237 

ASCII character 14, 2-318 
ASCII subcommand, 2-8, 2-61 
ASCII text, 2-229 
FORTRAN, 2-229 
Assembler , 

MACRO, 2-49, 2-87, 2-142, 
2-173, 2-326 
Assembling file, 2-87, 

2-142 

ASSIGN command, 2-17, 2-158 
Assigned device, 2-160 
Assigned disk storage pages, 
2-160 


Assigned memory pages, 

2-161 

Assigned pages, 2-160 
Assigned to job, 
device, 2-158 
Assigning device, 2-17 
Assigning infinite quota, 
2-33 

Assistance for batch job, 
specifying operator, 

2-290 

/ASSISTANCE switch, 2-290 
Asterisk appearing before 
filename, 2-111 
At sign prompt, 2-114, 

2-132 
;att, 1-1 

ATTACH command, 2-19, 2-181 
Attached job, 2-20, 2-184 
Attaching job, 2-19 
Attribute , 

; A , 2-64, 2-255 
file, 1-1 

file with Permanent, 2-96 
; FORMAT , 2-207 
; P , 2-64, 2-255 
Permanent, 2-147 
; T , 2-146 
Autobaud, 2-179 
Automatic retrieval-wait, 
2-259, 2-277 

AVAILABLE argument, 2-158, 
2-181 

AVAILABLE DEVICES argument, 
2-158 

AVAILABLE LINES argument, 
2-158 


BACKSPACE command, 2-22 
BACKSPACE with open file, 
2-22 

Backup copy of file, 
updating, 2-70, 2-126 
Backup file, 2-70, 2-128 
Backup file periodically, 
saving, 2-72, 2-129 
/BAK switch, 2-69, 2-126 
Balance set, 2-162 
BATCH argument, 2-188 
Batch control file, 2-288 
Batch input queue, 2-188 
placing request in, 2-288 
Batch job, 2-158, 2-180 
Batch job, 

access rights for, 2-295 
canceling, 2-40 
changing, 2-188 
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Batch job (Cont.) 

clearing default switches 
for, 2-275 
jobname of, 2-293 
modifyinq card limit of, 
2-191 

modifying paper tape 
limit of, 2-192 
modifying plotter limit 
of, 2-195 

modifying print limit of, 
2-19.4 

modifying priority of, 
2-195 

nested, 2-181 
notification upon 

satisfaction of, 2-291 
request ID number of, 

2-293 

setting defaults for 
nested, 2-295 
specifying account for, 
2-289 

specifying card limit for, 
2-290 

specifying connected 
directory for, 2-290 
specifying dependency 
count for, 2-290 
specifying jobname for, 
2-291 

specifying log file of, 
2-291, 2-295 
specifying operator 
assistance for, 2-290 
specifying owner of, 

2-293 

specifying paper tape 
limit for, 2-290 
specifying priority of, 
2-292 

specifying starting line 
for, 2-290 

specifying starting time 
for, 2-290 

specifying TAG:: for, 

2-292 

specifying uniqueness of, 
2-293 

submitting, 2-288 
talking to, 2-311 
time limit of, 2-293 
treatment of log file of, 
2-290, 2-291 
using group rights for, 
2-295 

using SET commands in, 
2-280 


Batch job after crash, 
resubmitting, 2-291 
Batch job concurrently, 
processing, 2-195 
Batch job consecutively, 
processing, 2-196 
Batch request, 
charging, 2-54 
Batch system, 2-158 
/BATCH-LOG switch, 2-290 
using, 2-293 

BATCH-REQUESTS argument, 
2-158 

BATCH.CMD, 

file specification, 2-180, 
2-295 

BATCH.CMD file, 2-92 
Baud rate, 2-168 
setting, 2-320 
BCD argument, 2-193, 2-237 
Beeps , 

high-pitched, 2-246, 

2-250, 2-310 

BEFORE subcommand, 2-107 
/BEGIN switch, 2-191, 2-219, 
2-229, 2-290 
Beginning job, 2-179 
Beginning new line, 1-4 
Beginning of magnetic tape, 
logical, 2-263 
Bells , 

ringing, 2-246, 2-250, 
2-310 

Between filespecs, 
commas, 2-89, 2-143, 

2-175 

plus signs, 2-50, 2-89, 
2-143, 2-175 
Between processes, 
competition, 2-242 
Between VT100 and VT52, 
talking, 2-311 
BINARY argument, 2-193, 

2-220, 2-237 
Binary file, 

generating, 2-48 
BINARY subcommand, 2-8, 

2-61 

/BINARY switch, 2-48 
Brackets , 

angle, 1-2, 1-4 
Break , 

address, 2-157 
canceling address, 2-271 
specifying address, 2-271 
BREAK command, 2-4, 2-24, 
2-181 

Breaking links, 2-24 
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BUILD command, 2-26, 2-160 
BUILD command subcommands, 
2-26 

BY-PAGES argument, 2-107 
BYPASS argument, 2-200 
Byte pointer, 2-160 
Byte size, 2-160 
Byte size of printed files, 
modifying, 2-192 
BYTE subcommand, 2-8, 2-62 


/C128 switch, 2-69, 2-126 

/C64 switch, 2-69, 2-126 

Calculation , 
checksum, 2-8 

CANCEL command, 2-38, 2-158, 
2-164, 2-196 

CANCEL command switches, 

2-40 

Canceling address break, 
2-271 

Canceling archival request, 
2-38 

Canceling batch job, 2-40 

Canceling card punch 
request, 2-38 

Canceling filled tape-mount 
request, 2-41 

Canceling mount request, 

2-38 

Canceling output request, 
2-40 

Canceling paper tape punch 
request, 2-38 

Canceling plotter request, 
2-38 

Canceling print request, 

2-38 

Canceling retrieval request, 
2-38 

Canceling SUBMIT command 
request, 2-38 

Capabilities, 2-1, 2-53, 
2-159, 2-180, 2-251 

Capabilities, 

Absolute -Arpanet -Sockets, 
2-27 

activating, 2-132 
Arpanet-Wizard, 2-27 
Confidential, 2-28 
disabling, 2-114, 2-132 
enabling, 2-132 
Enqueue-Dequeue, 2-28 
IPCF , 2-29 
Maintenance, 2-29 
Operator, 2-30 
suspending, 2-114 


Capabilities (Cont.) 

Wheel, 2-31 

Capabilities of log-in 
directory, 2-132 
Capabilities to 

subdirectory owners, 
granting, 2-34 
Capability , 

withheld log-out, 2-242 
Capacity , 

infinite storage, 2-33 
permanent disk storage, 
2-30, 2-184 
workinq disk storage, 

2-32' 

Card images as control file, 
submitting, 2-292 
Card limit for batch job, 
specifying, 2-290 
Card limit of batch job, 
modifying, 2-191 
Card punch, 2-164, 2-166 
Card punch, 

switch defaults for, 

2-238 

Card punch forms, 
specifying, 2-235 
Card punch output queue, 
2-233 

Card punch request, 
canceling, 2-38 
Card-handling device, 2-63 
CARD-READER-INPUT-SET 
argument, 2-272 
CARDS , 

clearing default switches 
for PUNCH, 2-275 
Cards , 

specifying set of punch, 
2-272 

CARDS argument, 2-38, 2-188, 
2-233, 2-272 

/CARDS switch, 2-191, 2-290 
Carriage control tape, 

2-192, 2-227 
. CBL , 

file type, 2-50, 2-88, 
2-143, 2-174 
CDP : , 2-164, 2-166 
CDR : , 2-272 

Changing batch job, 2-188 
Changing entry vector of 
program, 2-273 
Changing file, 2-125 
Changing file specification, 
2-254 

Changing output request, 
2-188 
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Channel , 

enabled, 2-165 
Character , 

$, 2-70, 2-93, 2-128 
%, 1-2, 2-70, 2-128 
', 2-317 
*, 1-2 
-, 2-93 

., 2-70, 2-128 
/, 1-2 
?, 1-6 

@, 2-114, 2-179 
flagging uppercase, 2-168 
lowercase, 2-69, 2-126, 
2-228 

non-alphanumer ic , 2-228 
printing lowercase, 2-168, 
2-319, 2-320 
uppercase, 2-71, 2-128, 
2-228 

vertical format, 2-230 
wildcard, 1-2, 2-216, 
2-225, 2-233, 2-254 
Characteristics, 

specifying terminal, 

2-315 

Characters , 

control, 2-162, 2-230 
echoing, 2-317 
non-alphanumer ic , 2-194 
printing uppercase, 2-317 
uppercase, 2-229 
wildcard, 2-64 
Charges for system 
resources, 2-180 
Charging batch request, 

2-54 

Charging output request, 

2-54 

Charging SUBMIT command 
request, 2-54 
/CHECK-SETNAME switch, 

2-200 

using, 2-204 
CHECKD program, 2-95 
Checking , 

array dimension, 2-89 
Checksum calculation, 2-8, 
2-62 

Checksum calculation, 
printing, 2-107 
CHECKSUM subcommand, 2-107 
Chronological list of files, 
printing, 2-107 
CHRONOLOGICAL subcommand, 
2-107 

CJB, 2-300 
Class of job, 

finding out scheduler, 


Class of job (Cont.) 

2-300 

CLASS subcommand, 2-300 
Clearing default switches 
for batch job, 2-275 
Clearing default switches 
for compiler, 2-275 
Clearing default switches 
for PLOT, 2-275 
Clearing default switches 
for PRINT, 2-275 
Clearing default switches 
for PUNCH CARDS, 2-275 
Clearing default switches 
for PUNCH PAPER-TAPE, 
2-275 

Clearing default switches 
for SUBMIT, 2-275 
Clearing memory, 2-152, 
2-257 

CLOSE command, 2-45 
Closing mapped file, 2-45 
Closing open file, 2-45, 
2-136 
. CMD , 

file type, 2-307 
COBDDT program, 2-88 
COBDDT.EXE program, 2-81 
COBOL argument, 2-192 
COBOL program again, 
running, 2-286 
COBOL report writer, 2-194, 
2-230 

COBOL SIXBIT text, 2-229 
/COBOL switch, 2-48, 2-86, 
2-141, 2-172 

COBOL-68 compiler, 2-48, 
2-86, 2-141, 2-172 
COBOL-74 compiler, 2-48, 
2-86, 2-141, 2-172 
Code , 

default file protection, 
2-28, 2-159 
directory protection, 

2-28, 2-31, 2-159 
file protection, 2-28 
specifying default 
protection, 2-272 
specifying protection, 
2-273 

Code for file, 

specifying protection, 
2-64, 2-274 
Colon, 1-4 

Column heading, 2-164 
COMAND.CMD, 

file specification, 2-180, 
2-231, 2-241, 2-279, 
2-294 
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Command , 

see name of command 
COMMAND argument, 2-320 
Command file, 2-182 

echoing of commands in, 
2-307 

error in, 2-307 
nested, 2-308 
processing, 2-307 
running program with, 
2-308 

Command level, 

creating lower TOPS-20, 
2-241 

program, 2-56 
TOPS-20 , 2-56 
Command line, 

SYSTAT subcommands on, 
2-303 

Command processor time, 
TOPS-20 , 2-165 
Command used by job, 
finding out, 2-301 
COMMAND-LEVEL argument, 
2-159, 2-181 
COMMAND-LEVEL command, 
INFORMATION, 2-274 
Commands , 

using SET DIRECTORY, 
2-281 

Commands for debugging, 
using SET, 2-280 
Commands in batch job, 
using SET, 2-280 
Commands in command file, 
echoing of, 2-307 
Commands that affect 

context of job, 2-57 
Commands to another job, 
giving, 2-4 

Commas between filespecs, 
2-89, 2-143, 2-175 
Comments only, 
sending, 2-252 
Communication links, 
ending, 2-24 
receiving, 2-246 
refusing, 2-250 
Comparing files, 2-111 
Compatibility package, 
TOPS -1 0 , 2-165, 2-278, 
2-326 

Compatible terminals, 2-5 
Competing for file, 
programs, 2-57 
Competing for files, 
programs, 2-242 
Competing for input, 
programs, 2-57, 2-242 


Competition between 
processes, 2-242 
Compilation , 

forcing, 2-87, 2-141 
switches assuming, 2-50 
Compilation of source file, 
forcing, 2-48 
preventing, 2-88, 2-142, 
2-173 

COMPILE command, 2-47 
COMPILE command switches, 
2-47 

/COMPILE switch, 2-48, 2-86, 
2-141, 2-172 

COMPILE-SWITCHES argument, 
2-272 

Compiler, 2-48, 2-86, 2-141, 
2-172 
Compiler , 

clearing default switches 
for, 2-275 

COBOL-68, 2-48, 2-86, 
2-141, 2-172 
COBOL-74, 2-48, 2-86, 
2-141, 2-172 
passing switches to, 

2-173 

Compilers, 2-326 
Compiling new sources only, 
2-88, 2-143, 2-174 
Complete error messages, 
2-71, 2-127 

Compressed copy of memory, 
2-78 

Compressed format, 2-78 
Compressing DIRECTORY 
format, 2-107 
Compute-bound process, 

2-162 

Concurrently, 

processing batch job, 

2-195 

Confidential capabilities, 
2-28 

CONFIDENTIAL subcommand, 

2-28 

Configuration file, 
system, 2-323 

CONNECT command, 1-2, 2-53, 
2-161 

Connected directory, 1-2, 
2-53, 2-54, 2-241 
Connected directory, 
expunging, 2-184 
printing, 2-161 
Connected directory for 
batch job, 
specifying, 2-290 
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Connected directory of job, 
finding out, 2-300 
Connected structure, 1-1 
/CONNECTED-DIRECTORY switch, 
2-290 

Connecting to directory, 

2-53 

Consecutively , 

processing batch job, 

2-196 

Console log-in, 2-167 
Contents of file, 

replacing previous, 2-255 
Contents of memory location, 
displaying, 2-138 
CONTENTS-ONLY subcommand, 
2-94 

Context of job, 

commands that affect, 

2-57 

CONTINUE argument, 2-102 
CONTINUE command, 1-6, 2-56 
CONTINUE command arguments, 
2-56 

CONTINUE STAY command, 

2-241 

Continuing inferior process, 
2-138 

Continuing program, 2-56, 
2-102 

Control character, 

inserting, 2-69, 2-126 
Control characters, 2-162, 
2-230 

Control file, 2-196 
batch, 2-288 
deleting, 2-290 
modifying first line of, 
2-191 

saving, 2-292 
specifying, 2-295 
submitting card images as, 
2-292 

CONTROL-C -CAPABILITY, 

SET, 2-165 

CONTROL-C -CAPABILITY 
argument, 2-272 
NO, 2-275 

CONTROL-C-CAP ABILITY 
command , 

SET, 2-165 

CONTROLLING argument, 2-301 
Controlling job of job, 
finding out, 2-300 
CONTROLLING subcommand, 

2-300 
Copies , 

modifying number of, 

2-191 


Copies of plotter request, 
specifying, 2-219 
Copies of print request, 
specifying, 2-229 
Copies of punch request, 
specifying, 2-237 
/COPIES switch, 2-191, 

2-219, 2-229, 2-237 
COPY command, 2-61, 2-166, 
2-255 

COPY command subcommands, 
2-61 

Copy of file, 
disk, 2-13 

preventing unedited, 2-69, 
2-126 

saving unedited, 2-69, 
2-126 

sharing, 2-78 
tape, 2-116 
updated, 2-72, 2-129 
updating backup, 2-70, 
2-126 

Copy of memory, 2-56 
compressed, 2-78 
fresh, 2-241 
more than one, 2-241 
Copy of off-line file, 
permanent, 2-13 
Copy of page, 

providing private, 2-276 
Copy of write-protected 
f ile , 

making modifiable, 2-279 
COPY-ON-WRITE argument, 

2-276 
NO, 2-276 

Copy-on-write page status, 
2-99 

Copying archived files, 

2-64 

Copying file, 2-61 
Copying from TTY:, 2-64 
Copying program in memory, 
2-78 

CORE-DUMP argument, 2-278 
CORE-DUMP format, 2-167 
Correct process, 
specifying, 2-168 
Count , 

default generation 
retention, 2-273 
modifying dependency, 

2-192 

specifying generation 
retention, 2-273 
Count for batch job, 
specifying dependency, 
2-290 
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Count of file, 

specifying generation 
retention, 2-274 
Count of structure, 

reducing mount, 2-120 
Counts , 

differing page, 2-147 
CPU percentages alloted to 
and used by each job, 
finding out, 2-300 
CPU time, 2-162, 2-165 
CPU time, 

specifying, 2-279 
CPU time limit, 
modifying, 2-195 
specifying, 2-293 
CPU time of job, 

finding out accumulated, 
2-301 

CPU-bound process, 2-162 
CRAM subcommand, 2-107 
Crash , 

resubmitting batch job 
after, 2-291 
system, 2-194 
CREATE command, 2-68 
CREATE command switches, 

2-68 

CREATED argument, 2-110 
Creating directory, 2-26 
Creating file, 2-68 
Creating lower TOPS-20 
command level, 2-241 
Creating new level of 
TOPS-20 , 2-241 
CREATION argument, 2-107, 
2-110 

CREF command, 2-48, 2-72, 
2-141, 2-172 
CREF program, 2-326 
/P switch of, 2-76 
/CREF switch, 2-48, 2-72, 
2-86, 2-141, 2-172 
. CRF , 

file type, 2-48, 2-72, 
2-86, 2-141, 2-172 
.CRF file, 

preserving, 2-76 
producing, 2-49, 2-72 
CRLF , 2-230 

Cross-reference file, 2-48, 
2-72, 2-86, 2-141, 

2-172 

Cross-reference listing, 

2-48, 2-72, 2-86, 2-141, 
2-172 
CSAVE , 

inefficency of, 2-78 
CSAVE command, 2-78, 2-186 


. CTL , 

file type, 2-288 
CTRL/C, 2-162, 2-263, 2-328 
CTRL/C, 

typing initial, 2-179 
CTRL/C interrupt, 2-165 
handling, 2-272 
CTRL/E, 2-4 

CTRL/ECREATE command, 2-32 
CTRL/G signals, 2-246, 

2-250, 2-310 
CTRL/K, 2-230 
CTRL/L, 2-230, 2-318 
CTRL/O, 2-162, 2-328 
CTRL/Q, 2-230, 2-319 
CTRL/R, 2-230 
CTRL/S, 2-230, 2-319 
CTRL/T, 2-162, 2-230 
CTRL/Z, 2-10, 2-252 
CTRL/'?, 2-4 

Current and lower levels of 
TOPS-20 , 2-257 

Current day, date, and time, 
printing, 2-80 
Current job, 2-19 
disengaging, 2-102 
Current level of TOPS-20, 
2-165, 2-180, 2-279 
Current level of TOPS-20, 
terminating, 2-223 
Current object file, 2-49, 
2-86, 2-87, 2-141, 

2-142, 2-172, 2-173 
Current process, 
finding, 2-168 
finishing, 2-257 
Current process of job, 

2-161 

Current program, 

printing version of, 

2-168 

Current terminal session, 
2-279 

/CURRENT-VOLUME-ONLY switch, 
2-263 
CW, 2-162 


Damaged file, 
removing, 2-95 
.DAT, 

file type, 2-229 
DATA ERROR, 2-160 
Data modes for magnetic 
tape, 

hardware, 2-278 
Date , 

write, 2-49, 2-88, 2-174 
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Date and time of last 
log-in, 2-160 
Date, and time, 

printing current day,, 
2-80 

Dates of file, 
printing, 2-108 
DATES subcommand, 2-108 
Day, date, and time, 
printing current, 2-80 
DAYTIME command, 2-80, 

2-181 

DCN : , 2-63 
DDT command, 2-81 
DDT debugging program, 2-86 
DDT program 2-88, 2-99, 
2-138, 2-172 

/DDT switch, 2-86, 2-172 
DEASSIGN command, 2-83 
Deassigning device, 2-83 
DEBUG command, 2-85 
DEBUG command switches, 

2-85 

/DEBUG switch, 2-49, 2-86, 
2-142, 2-172, 2-173 
Debugging , 

using SET commands for, 
2-280 

Debugging FORTRAN program, 
2-89 

Debugging information, 
excluding, 2-49, 2-87, 
2-173 

inserting, 2-48, 2-86, 
2-172 

Debugging program, 2-174 
DDT, 2-86 

loading, 2-81, 2-85 
merging, 2-81 
Debugging programs, 2-129 
/DECIDE switch, 2-69, 2-126 
DECNET command, 

INFORMATION, 2-275 
DECnet network, 2-159 
DECnet network node, 
setting, 2-275 
DECnet network node for log 
f ile , 

specifying, 2-291 
DECnet network node for 
output , 

specifying, 2-191 
DECnet network node for 
plotter output, 
specifying, 2-218 
DECnet network node for 
printed output, 
specifying, 2-227 


DECnet network node for 
processing , 

specifying, 2-194, 2-292 
DECnet node for punched 
output , 

specifying, 2-235 
DECNET NODES argument, 

2-159 
Default , 

generation retention 
count, 2-159 
Default account, 2-159 
specifying, 2-272 
Default address for DEPOSIT, 
2-100 

Default address for EXAMINE, 
2-138 

DEFAULT argument, 2-272 
NO, 2-275 

Default arguments, 1-4 
Default file protection 
code, 2-28, 2-159 
Default generation 

retention count, 2-273 
DEFAULT PRINT command, 
using SET, 2-231 
Default protection code, 
specifying, 2-272 
DEFAULT SUBMIT command, 
using SET, 2-294 
Default switch, 1-3 
Default switches, 

specifying, 2-231, 2-272, 
2-295 

Default switches for batch 
job, 

clearing, 2-275 
Default switches for 
compiler , 
clearing, 2-275 
Default switches for PLOT, 
clearing, 2-275 
Default switches for PRINT, 
clearing, 2-275 
Default switches for PUNCH 
CARDS, 

clearing, 2-275 
Default switches for PUNCH 
PAPER-TAPE , 
clearing, 2-275 
Default switches for SUBMIT, 
clearing, 2-275 
DEFAULT-FILE -PROTECTION 
subcommand, 2-28 
Defaults, 1-4 
Defaults for card punch, 
switch, 2-238 
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Defaults for nested batch 
job, 

setting, 2-295 
Defaults for paper tape 
punch , 

switch, 2-238 
Defaults for plotter, 
switch, 2-220 
Defaults set by system 

manager, 2-230, 2-293, 
2-323 

DEFERRED argument, 2-277 
DEFINE command, 2-92, 2-161, 
2-180 

Defining logical name, 2-92 
Defining SYS:, 2-244 
Definition , 

logical name, 2-241 
printing logical name, 
2-161 

Delaying migration of file, 
2-280 

DELETE command, 1-2, 2-94, 
2-255 

DELETE command subcommands, 
2-94 

DELETE subcommand, 2-146 
/DELETE switch, 2-191, 

2-219, 2-229, 2-237, 
2-290 

Deleted archived file, 
recovering, 2-96 
Deleted file, 
erasing, 2-332 
restoring, 2-332 
Deleted files, 

printing list of, 2-108 
Deleted pages, 2-160 
DELETED subcommand, 2-108 
Deleting and expunging 
directory file, 2-94 
Deleting archived file, 

2-94 

Deleting control file, 

2-290 

Deleting directory, 2-26 
Deleting disk copy of file, 
2-94 

Deleting file, 2-94 
Deleting file after 
printing, 2-229 
Delimiters, 

field, 2-70, 2-127, 2-128 
Demonstrating command, 

2-252 
Density , 

magnetic tape, 2-167 
specifying magnetic tape, 
2-277 


DENSITY argument, 

TAPE, 2-277 
DENSITY command, 

SET TAPE, 2-207 
Density of tape, 
specifying, 2-200 
/DENSITY switch, 2-200 
Dependency count, 
modifying, 2-192 
Dependency count for batch 
job, 

specifying, 2-290 
/DEPENDENCY-COUNT switch, 
2-191, 2-196, 2-290 
DEPOSIT, 

default address for , 

2-100 

DEPOSIT command, 1-6, 2-99 
Descriptor Block of file, 
File, 2-116 

Destination file, 2-8, 2-61 
/DESTINATION-NODE switch, 
2-191, 2-218, 2-227, 
2-235, 2-275, 2-291 
Destroying contents of file, 
2-64 

DET, 2-20, 2-300 
DETACH command, 2-20, 2-102 
DETACH command arguments, 
2-102 

DETACHED argument, 2-300 
Detached job, 2-5, 2-19 
Detached job, 

inefficiency of, 2-102 
Detached job for SYSTAT, 
specifying, 2-300 
Dev : , 1-1 

Dev: arguments for mounting 
tape , 

dummy, 2-206 
Device, 1-1 

assigned, 2-160 
assigning, 2-17 
card-handling, 2-63 
deassigning, 2-83 
modifying unit number of 
output, 2-195 
MTAn : , 2-17 
MTn : , 2-17 
open, 2-160 

paper-tape-handling, 2-63 
returning, 2-83 
surrendering, 2-83 
Device assigned to job, 

2-158 

Device name, 
logical, 2-17 
DEVICES argument, 2-158 
AVAILABLE, 2-158 
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Dial-up line, 2-323 
Dialing in by telephone, 
2-179 

Differing page counts, 

2-147 

Dimension checking, 
array, 2-89 
Dir, 1-1 
DIR. DIR, 

file specification, 2-109 
<dir>, 1-1 
Directory , 

accessed, 2-241 
capabilities of log-in, 
2-132 

connected, 1-2, 2-53, 
2-54, 2-241 
connecting to, 2-53 
creating, 2-26 
deleting, 2-26 
expunging connected, 

2-184 

expunging log-in, 2-184 
.DIRECTORY, 

file type, 2-33, 2-64 
Directory , 

files-only, 2-28, 2-34 
highest-level superior, 
2-33 

information on, 2-159 
killing, 2-34 
log-in, 1-2, 2-53, 2-54, 
2-180, 2-231, 2-241, 
2-294 

modifying, 2-26, 2-34 
ownership rights to, 2-1, 
2-53, 2-134 
ownership rights to 
log-in, 2-180 
password of, 2-159 
printing connected, 2-161 
printing log-in, 2-161 
quota of superior, 2-33 
read access to, 2-295 
subordinate, 2-26 
superior, 2-32 
write access to, 2-295 
DIRECTORY ACCOUNT-DEFAULT 
argument, 2-272 
DIRECTORY argument, 2-159, 
2-272, 2-301 
DIRECTORY command, 1-2, 

2-105 

DIRECTORY command, 

Full, 2-149 

INFORMATION, 2-33, 2-272 
SET, 2-34 

Time-ordered, 2-314 
Verbose, 2-336 


DIRECTORY command 

subcommands, 2-105 
DIRECTORY commands, 
using SET, 2-281 
Directory file, 

deleting and expunging, 
2-94 

DIRECTORY 

FILE-PROTECTION-DEFAULT 
argument, 2-272 
Directory for batch job, 
specifying connected, 

2-290 

DIRECTORY format, 
compressing, 2-107 
Directory name, 1-1 
translating, 2-326 
Directory number, 2-30, 

2-159 

Directory owner, 

group rights of, 2-1, 

2-134 

DIRECTORY PASSWORD argument, 
2-273 

DIRECTORY PROTECTION 
argument, 2-273 
Directory protection code, 
2-28, 2-31, 2-159 
DIRECTORY subcommand, 2-94, 
2-300 

DIRECTORY-class command, 

1- 3, 2-105, 2-111, 

2- 149, 2-166, 2-314, 
2-336 

DIRECTORY-class command for 
magnetic tape, 2-111, 
2-149 

DIRECTORY-GROUP subcommand, 
2-28 

DIRECTORY. OWNER, 

file specification, 2-95 
DIRECTORY. OWNER file 

specification, 2-13 
DISABLE command, 2-114 
Disabling capabilities, 
2-114, 2-132 

DISALLOW subcommand, 2-307 
DISCARD, 

undoing, 2-117 
DISCARD command, 2-116 
Disengaging another job, 
2-330 

Disengaging current job, 
2-102 
Disk , 

restoring off-line file 
to, 2-258 

Disk copy of file, 2-13 
deleting, 2-94 
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Disk file, 

ordinary, 2-259 
Disk pages freed, 2-147 
Disk quotas, 2-110 
Disk space, 

withholding freed, 2-95 
Disk storage capacity, 
permanent, 2-30, 2-184 
working, 2-32 
Disk storage limit, 
permanent, 2-32 
working, 2-32 
Disk storage pages, 
assigned, 2-160 
DISK-USAGE argument, 2-160 
Disks in structure, 
number of, 2-166 
DISMOUNT command, 2-119, 
2-166 

Dismounting magnetic tape 
set, 2-121 

Dismounting structure, 

2-121 

Displaying contents of 

memory location, 2-138 
Disposition of log file, 
2-293 

Disregarding terminal input 
after error, 2-274 
Dollar sign prompt, 2-114, 
2-132 

Domestic structure, 2-166 
DOUBLE argument, 2-230 
Double quotation marks, 
2-194, 2-228 

Double-spaced list of files, 
2-108 

DOUBLESPACE subcommand, 

2-108 

/DPY switch, 2-69, 2-126 
Dr ive , 

magnetic tape, 2-136 
Drive type for magnetic 
tape, 

specifying, 2-200 
/DRIVE-TYPE switch, 2-200 
DSK : , 2-265 

Dummy dev: arguments for 
mounting tape, 2-206 


E, 2-162 

EBCDIC argument, 2-200 
ECHO subcommand, 2-307 
Echoing of commands in 
command file, 2-307 
Echoing TAB and linefeed, 
2-317, 2-319 


"ECREATE command, 2-32 
EDIT command, 2-125 
EDIT command switches, 

2-125 

Edit mode, 

Input mode and, 2-71, 

2-128 

EDIT program, 

G command of, 2-70, 2-127 
P command of, 2-70, 2-127 
read-only session of, 

2-71, 2-127 

S command of, 2-69, 2-126 
EDIT-class command, 1-2, 
2-68, 2-125 

Editing archived files, 

2-129 

Editing file, 2-125 
Editing files of type . Qyp, 
2-129 

Editing program, 2-72, 

2-129 

Editinq program, 

TV, 2-72, 2-129 
Editing source files, 2-129 
Editor, 2-72, 2-129 
EDITOR: , 

logical name, 2-72, 2-129 
Efficiency of RENAME, 2-254 
Efficiency of RUN, 2-265 
Elapsed time, 2-165 
ELEVEN argument, 2-192, 
2-229 

ENABLE command, 2-132 
Enabled channel, 2-165 
Enabling capabilities, 

2-132 

End of tape, 
logical, 2-283 
END-ACCESS , 

implicit, 2-134 
END-ACCESS command, 2-134 
End-of-file mark, 2-136, 
2-283 

END-OF-PAGE argument, 2-320 
Ending communication links, 
2-24 

Ending job, 2-184 
Ending links, 2-24 
Engaging job, 2-19 
ENQ-DEQ subcommand, 2-28 
Enqueue -Dequeue 

capabilities, 2-28 
/ENTIRE -VOLUME -SET switch, 
2-263 

Entry point of program, 
alternate, 2-248 
Entry vector, 2-186 

location 120 of, 2-286 
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Entry vector (Cont. ) 
location 124 of, 2-248 
location and length of, 
2-161 

Entry vector of program, 
2-286 

changing, 2-273 
ENTRY -VECTOR argument, 

2-273 

EOF, 2-160 
EOF command, 2-136 
EOF mark, 2-107, 2-136, 
2-283 
Erased , 

file permanently, 2-332 
Erasing deleted file, 2-332 
Erasing file, 2-94, 2-146 
Erasure , 

marking file for, 2-94 
Error , 

accepting terminal input 
after, 2-275 
disregarding terminal 
input after, 2-274 
hardware-related, 2-111 
Error in command file, 

2-307 

Error messages, 2-159 

abbreviated, 2-70, 2-127 
complete, 2-71, 2-127 
ERRORS argument, 2-291 
ESC key, 1-2, 1-5 
ESCape key, 1-2 
Establishing logical name, 
2-92 

EVEN argument, 2-278 
EVEN parity, 2-167 
EVERYTHING subcommand, 

2-108 

EXAMINE, 

default address for, 

2-138 

EXAMINE command, 1-6, 2-138 
Examining memory for 

inferior process, 2-138 
Examining memory location, 
2-138 

Excluding debugging 

information, 2-49, 2-87, 
2-173 
.EXE, 

file type, 2-78, 2-152, 
2-186, 2-244, 2-265 
EXEC, 2-165, 2-241 
EXECUPORT argument, 2-317 
Executable file, 2-267 
Executable format, 2-78 
Executable program, 2-70, 
2-127, 2-152 


Executable program, 
running, 2-244, 2-265 
starting, 2-286 
Executable program in 
memory , 

placing, 2-186 
Execute access, 2-160 
Execute access of page, 
specifying, 2-276 
EXECUTE argument, 2-276 
EXECUTE command, 1-6, 2-140, 
2-265 

EXECUTE command switches, 
2-140 

EXECUTE subcommand, 2-271 
Executing program, 2-140 
Execution of program, 
resuming, 2-56 
Existing tape set, 

writing new file set on, 
2-201 

/EXPERT switch, 2-69, 2-126 
Explanation of load average, 
2-302 

Explanatory text, 2-154 
EXPUNGE command, 2-146, 

2-332 

EXPUNGE command subcommands, 
2-146 

EXPUNGE subcommand, 2-94, 
2-332 

Expunging archived file, 

2-94 

Expunging connected 
directory, 2-184 
Expunging directory file, 
deleting and, 2-94 
Expunging file, 2-94, 2-146 
Expunging log-in directory, 
2-184 


FAST argument, 2-29 
FAST subcommand, 2-159 
/FAST switch, 2-158, 2-163, 
2-164, 2-165 
FDB of file, 2-116 
FDIRECTORY command, 2-149, 
2-273 

/FEET switch, 2-192, 2-291 
Field delimiters, 2-70, 
2-127, 2-128 
Field separators, 2-70, 
2-127, 2-128 
FILCOM program, 2-155, 

2-326 
File , 

accessing open, 2-83 
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allowing migration of, 
2-274 

archive status of, 2-157 
archived, 2-13 
assembling, 2-87, 2-142 
avoiding checking of mail, 
2-276 

BACKSPACE with open, 2-22 
backup, 2-70, 2-128 
batch control, 2-288 
BATCH.CMD, 2-92 
changing, 2-125 
checking mail, 2-275 
closing mapped, 2-45 
closing open, 2-45, 2-136 
command, 2-182 
control, 2-196 
copying, 2-61 
creating, 2-68 
cross-reference, 2-48, 
2-72, 2-86, 2-141, 

2-172 

current object, 2-49, 

2-86, 2-87, 2-141, 

2-142, 2-172, 2-173 
delaying migration of, 
2-280 

deleting, 2-94 
deleting and expunging 
directory, 2-94 
deleting archived, 2-94 
deleting control, 2-290 
deleting disk copy of, 
2-94 

destination, 2-8, 2-61 
destroying contents of, 
2-64 

disk copy of, 2-13 
disposition of log, 2-293 
echoing of commands in 
command, 2-307 
editing, 2-125 
erasing, 2-94, 2-146 
erasing deleted, 2-332 
error in command, 2-307 
executable, 2-267 
expunging, 2-94, 2-146 
expunging archived, 2-94 
FDB of, 2-116 
File Descriptor Block of, 
2-116 

finding outdated 

generations of, 2-108 
finding unneeded, 2-110 
forcing compilation of 
source, 2-48 
forcing use of object, 
2-88, 2-142 
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generating binary, 2-48 
generating object, 2-48 
globally optimized object, 
2-49, 2-87, 2-142, 

2-173 

Help, 2-154 
holes in, 2-107 
indirect, 2-50, 2-89, 

2-143, 2-175 
invisible, 2-14, 2-258 
line numbers in, 2-69, 

2-126 

LOGIN.CMD, 2-92 
MAIL.TXT, 2-96 
making, 2-68 

making modifiable copy of 
write-protected, 2-279 
mapped, 2-257 
migrated, 2-116 
nested command, 2-308 
object, 2-47, 2-171 
off-line, 2-277 
off-line status of, 2-259 
open, 2-146, 2-160 
ordinary disk, 2-259 
permanent copy of 
off-line, 2-13 
preserving .CRF, 2-76 
preventing compilation of 
source, 2-88, 2-142, 
2-173 

preventing migration of, 
2-274 

preventing unedited copy 
of, 2-69, 2-126 
printing account for, 
2-107, 2-112 

printing dates of, 2-108 
printing information 
about, 2-105 

printing length of, 2-108 
printing line numbers for, 
2-71, 2-127 

printing protection code 
for , 2-109 
printing protection 
number of, 2-109 
printing size of, 2-110 
printing times of, 2-110 
printing user of, 2-110 
processing command, 2-307 
producing .CRF, 2-49, 

2-72 

programs competing for , 
2-57 

recovering deleted 
archived, 2-96 
relocatable binary, 2-47 
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removing damaged, 2-95 
removing open, 2-95 
renaming archived, 2-255 
renaming mapped, 2-255 
renaming open, 2-255 
replacing previous 
contents of, 2-255 
restoring deleted, 2-332 
running program with 
command, 2-308 
saving control, 2-292 
saving recent generations 
of, 2-95 

saving unedited copy of, 
2-69, 2-126 
sending SYSTAT 

information to, 2-301 
sharing copy of, 2-78 
SKIP with open, 2-283 
source, 2-8, 2-47, 2-61, 
2-171 

specifying account for, 
2-64, 2-273 

specifying control, 2-295 
specifying generation 
retention count of, 
2-274 

specifying printing of 
log, 2-291 

specifying protection 
code for, 2-64, 2-274 
stripping line numbers 
from, 2-71, 2-128 
suppressing line numbers 
for, 2-71, 2-127 
SWITCH . INI , 2-70, 2-72 
system configuration, 

2-323 

tape copy of, 2-116 
tape pointer to, 2-116 
temporary, 2-146 
translating source, 2-47 
updated copy of, 2-72, 
2-129 

updating backup copy of, 
2-70, 2-126 

using retrieved, 2-259 
waiting for retrieval of 
off-line, 2-277 
withdrawing archive 
status of, 2-116 
File after printing, 
deleting, 2-229 
saving, 2-230 
FILE argument, 2-273 
File attribute, 1-1 
File Descriptor Block of 
file, 2-116 


File for erasure, 
marking, 2-94 
File invisible, 
making, 2-274 
File is printed, 
when log, 2-294 
File is written, 
where log, 2-294 
File library, 

object, 2-88, 2-142, 

2-173 

File lines, 

suppressing, 2-109 
File MONSYM . MAC , 

system parameter, 2-81 
File of batch job, 

specifying log, 2-291, 
2-295 

File on terminal, 
printing, 2-328 
File page, 2-162 
File periodically, 
saving backup, 2-72, 

2-129 

File permanently erased, 
2-332 

File pointer, 2-160 
FILE PROHIBIT command, 

SET, 2-280 

File protection code, 2-28 
default, 2-28, 2-159 
File set identifiers, 2-204 
File set on existing tape 
set , 

writing new, 2-201 
File set on new tape set, 
writing new, 2-202 
File space, 

forgetting, 2-95 
File specification, 1-1 
changing, 2-254 
DIRECTORY. OWNER, 2-13 
File specification 

BATCH.CMD, 2-180, 2-295 
File specification 

COMAND.CMD, 2-180, 

2-231, 2-241, 2-279, 
2-294 

File specification DIR. DIR, 
2-109 

File specification 

DIRECTORY. OWNER, 2-95 
File specification LNK.MAP, 
2-87, 2-142, 2-173 
File specification 

LOGIN.CMD, 2-180, 2-323 
File specification MAIL. TXT, 
2-96, 2-147, 2-258 
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MIGRATION. ORDER, 2-280 
File specification name.Qyp, 
2-69, 2-126 

File specification name.Zyp, 
2-70, 2-127 
File specification 

nnnLNK . MAP , 2-87, 2-142, 
2-173 

File specification 

object. MAP, 2-87, 2-142, 
2-173 

File specification 

PA1050.EXE, 2-278, 

2-326 

File specification 

PS : LOGIN . CMD , 2-180 
File specification 

PS : SWITCH . INI , 2-127 
File specification 

SWITCH . INI , 2-127, 

2-129 

File specification 

SYSTAT.LST, 2-301 
File structure, 1-1 
mounting, 2-199 
unused pages on, 2-160 
File switch, 2-216, 2-225, 
2-233 

/FILE switch, 2-192, 2-229 
File to disk, 


restoring off-line, 2-258 
File to spooling area only, 


writing 

log, 2-294 


File type, 

1-1 

00 

00 

1 

nonstandard, 2-50, 2 

2-143, 

2-174 


standard 

, 2-48, 2-50 

r 

2-87, 

2-88, 2-141, 


2-143, 

2-173, 2-174 

File type 

.ALG, 2-50, 

00 

00 

1 

CM 

2-143, 

2-174 


File type 

. CBL , 2-50, 

OO 

OO 

1 

CM 

2-143, 

2-174 


File type 

.CMD, 2-307 


File type 

. CRF , 2-48, 

2-72, 

2-86, 

2-141, 2-172 


File type 

. CTL , 2-288 


File type 

.DAT, 2-229 


File type 

.DIRECTORY, 

2-33, 

2-64 



File type 

.EXE, 2-78, 

2-152, 

2-186, 

2-244, 2-265 

File type 

.FOR, 2-50, 

2-88, 

2-143, 

2-174 


File type 

. HLP , 2-154 


File type 

.LOG, 2-291 


File type 

. LST , 2-229 



File type .MAC, 2-50, 2-88, 
2-143, 2-174 

File type .MAP, 2-87, 2-142, 
2-173 

File type .Qyp, 2-69, 2-126 
File type .REL, 2-89, 2-143, 
2-171, 2-175 

File type .Zyp, 2-70, 2-127 
File visible, 
making, 2-274 
File with Permanent 
attribute, 2-96 
FILE-PROTECTION-DEFAULT 
argument , 

DIRECTORY, 2-272 
File-read, 2-162 
FILE-STATUS argument, 2-160 
File-write, 2-162 
Filename, 1-1 
Files , 

appending, 2-8 
comparing, 2-111 
copying archived, 2-64 
double-spaced list of, 

2-108 

editing archived, 2-129 
editing source, 2-129 
mixing sequenced and 
unsequenced, 2-10 
modifying byte size of 
printed, 2-192 
modifying mode of output, 
2-193 

printing alphabetical 
list of, 2-107 
printing chronological 
list of, 2-107 
printing headline for 
list of, 2-108 
printing list of archived, 
2-107 

printing list of deleted, 
2-108 

printing list of 
invisible, 2-108 
printing list of large, 
2-108 

printing list of new, 

2-109 

printing list of old, 

2 — 1 0 7 

printing list of outdated, 
2-108 

printing list of small, 
2-110 

programs competing for , 
2-242 

specifying account for, 


Index-19 



INDEX (CONT.) 


Files (Cont . ) 

2-217, 2-235 
specifying mode of 
plotter, 2-220 
specifying mode of 
punched, 2-237 
FILES argument, 2-283 
Files of type -Qyp, 
editing, 2-129 
Files via network, 

transferring, 2 - 9 , 2-63 
Files-only directory, 2-28, 
2-34 

FILES-ONLY subcommand, 2-28 
Filespec , 
long, 2-175 
Filespecs, 1-1 

commas between, 2-89, 
2-143, 2-175 

plus signs between, 2-50, 
2-89, 2-143, 2-175 
Filled tape-mount request, 
canceling, 2-41 
FIND subcommand, 2-108 
Finding current process, 
2-168 

Finding out accumulated CPU 
time of job, 2-301 
Finding out accumulated 
runtime of job, 2-301 
Finding out command used by 
job, 2-301 

Finding out connected 

directory of job, 2-300 
Finding out controlling job 
of job, 2-300 

Finding out CPU percentages 
alloted to and used by 
each job, 2-300 
Finding out information 
about job, 2-300 
Finding out information 
about system, 2-300 
Finding out program used by 
job, 2-301 

Finding out scheduler class 
of job, 2-300 
Finding out state of job, 
2-301 

Finding out time limit for 
job, 2-300 
Finding outdated 

generations of file, 
2-108 

Finding unneeded file, 

2-110 

Finishing current process, 
2-257 


Finishing inferior process, 
2-257 

Finishing job, 2-184 
First line of control file, 
modifying, 2-191 
First page of output, 
modifying, 2-191 
Five minutes, 

log-in within, 2-182 
FLAG argument, 2-317 
Flagging uppercase 
character, 2-168 
. FOR, 

file type, 2-50, 2-88, 
2-143, 2-174 

Forcing compilation, 2-87, 
2-141 

Forcing compilation of 
source file, 2-48 
Forcing use of object file, 
2-88, 2-142 
FORDDT program, 2-88 
Foreign structure, 2-166 
FORGET subcommand, 2-95 
Forgetting file space, 2-95 
Fork 0, 2-150 
FORK command, 2-150 
FORK n, 2-162 
Fork of job, 2-150 
Fork zero, 2-150 
Format , 

ANSI-ASCII, 2-167 
compressed, 2-78 
compressing DIRECTORY, 
2-107 

CORE-DUMP, 2-167 
executable, 2-78 
INDUSTRY-COMPATIBLE , 

2-167 

magnetic tape, 2-167 
specifying magnetic tape, 
2-278 

SYSTEM-DEFAULT, 2-167 
FORMAT argument, 

TAPE, 2-278 

; FORMAT attribute, 2-2Q7 
Format character, 
vertical, 2-230 
FORMAT command , 

SET TAPE, 2-207 
Format of forms, 

vertical, 2-192, 2-227 
Format of print request, 
specifying, 2-229 
Formfeed, 2-230 
simulating, 2-317 
FORMFEED argument, 2-317 
Formfeed mechanism, 2-168 
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Forms , 

modifying line printer, 
2-192 

specifying card punch, 
2-235 

specifying line printer, 
2-227 

specifying paper tape 
punch, 2-235 

specifying plotter, 2-218 
vertical format of, 2-192, 
2-227 

/FORMS switch, 2-164, 2-192, 
2-218, 2-227, 2-235 
FORTRAN argument, 2-192, 
2-229 

FORTRAN ASCII text, 2-229 
FORTRAN program, 
debugging, 2-89 
/FORTRAN switch, 2-48, 2-87, 
2-141, 2-173 
Forward , 

moving magnetic tape, 

2-283 

Freed disk space, 
withholding, 2-95 
Freeing hung terminal, 

2-330 

Frequently run program, 
storing, 2-265 
Fresh copy of memory, 2-241 
Full DIRECTORY command, 

2-149 

FULLDUPLEX argument, 2-317 
FULLDUPLEX mode, 2-168 


G command of EDIT program, 
2-70, 2-127 
.gen, 1-1 

Generating binary file, 

2-48 

Generating object file, 

2-48 

Generation , 
highest, 1-2 
Generation number, 1-1 
Generation retention count, 
2-29 

default, 2-273 
specifying, 2-273 
Generation retention count 
default, 2-159 
Generation retention count 
of f ile , 

specifying, 2-274 
GENERATION-RETENTION-COUNT 
argument, 2-274 


Generations of file, 

finding outdated, 2-108 
saving recent, 2-95 
GENERATIONS subcommand, 

2-29 

/GENERIC switch, 2-192, 
2-218, 2-228, 2-235 
GET command, 2-152, 2-265 
Getting new level of 
TOPS-20 , 2-223 
Giving commands to another 
job, 2-4 

Global switch, 2-47, 2-85, 
2-140, 2-225 
Global switches, 1-3 
Globally optimized object 

file, 2-49, 2-87, 2-142, 
2-173 

Granting capabilities to 
subdirectory owners, 

2-34 

Greeting , 

system herald or, 2-179 
Group membership, 2-160 
Group number, 2-160 
Group rights, 2-180 
obtaining, 2-53 
restoring, 2-1, 2-134 
Group rights for batch job, 
using, 2-295 

Group rights of directory 
owner, 2-1, 2-134 
Groups, 2-28, 2-31, 2-33, 
2-160 


HALFDUPLEX argument, 2-317 
HALFDUPLEX mode, 2-168 
Handling CTRL/C interrupt, 
2-272 

Hardware data modes for 
magnetic tape, 2-278 
Hardware-related error, 
2-111 

HEADER argument, 2-301 
Header page, 

specifying, 2-229 
Header page of plotter 
request , 

specifying, 2-219 
Header section of punch 
request , 

specifying, 2-237 
HEADER subcommand, 2-300 
/HEADER switch, 2-192, 
2-219, 2-229, 2-237 
Heading , 

column, 2-164 
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HEADING subcommand, 2-108 
Headline , 

suppressing, 2-109 
Headline for list of files, 
printing, 2-108 
Headline for SYSTAT, 
printing, 2-300 
HELP argument, 2-317 
HELP command, 2-154 
HELP command arguments, 
2-154 

Help file, 2-154 
Herald or greeting, 
system, 2-179 
HIGH-DENSITY argument, 

2-278 

Higher-level program, 2-57 
Highest generation, 1-2 
Highest-level superior 
directory, 2-33 
. HLP , 

file type, 2-154 
HLP: , 

logical name, 2-154 
Holes in file, 2-107 
Horizontal tab, 2-230 
Host node, 2-275 
Hung job, 2-102 
Hung terminal, 
freeing, 2-330 


ID argument, 

request, 2-38, 2-188 
ID number, 

request, 2-38, 2-163, 
2-166, 2-188 
ID number of batch job, 
request, 2-293 
Identification , 

specifying structure, 
2-203 

structure, 2-119 
Identifier, 2-38, 2-188 
IMAGE argument, 2-193, 
2-220, 2-237 

IMAGE BINARY subcommand, 
2-9, 2-62 

IMAGE subcommand, 2-9, 2-62 
IMAGE-BINARY argument, 
2-193, 2-237 

IMMEDIATE argument, 2-277, 
2-317 

Immediately superior 
directory, 2-32 
IMP, 2-158 

Implicit access with LOGIN 
command, 2-1 


Implicit END-ACCESS, 2-134 
Implicit refusal of advice, 
2-251 

Implied retrieval request, 
2-259 

/INCREMENT switch, 2-69, 
2-126 

INDICATE argument, 2-318 
Indirect file, 2-50, 2-89, 
2-143, 2-175 
Indirect pointer, 2-162 
INDUSTRY-COMPATIBLE 
argument, 2-278 
INDUSTRY-COMPATIBLE format, 
2-167 

Inefficency of CSAVE , 2-78 
Inefficiency of detached 
job, 2-102 
Inferior process, 
continuing, 2-138 
examining memory for, 

2-138 

finishing, 2-257 
modifying memory for, 

2-100 

Infinite quota, 
assigning, 2-33 
Infinite storage capacity, 
2-33 

Information , 

excluding debugging, 2-87, 
2-173 

inserting debugging, 2-86, 
2-172 

restricting SYSTAT, 2-301 
sample of SYSTAT, 2-302 
Information about file, 
printing, 2-105 
Information about job, 
finding out, 2-300 
Information about system, 
finding out, 2-300 
INFORMATION command, 2-156, 
2-181 

INFORMATION command 
arguments, 2-156 
Information for operator 
job, 2-304 

Information on directory, 
2-159 

Information on system and 
job, 2-156 

Information to file, 
sending SYSTAT, 2-301 
Initial CTRL/C, 
typing, 2-179 
Initialization procedure, 
2-248 
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Input , 

programs competing for, 
2-57, 2-242 
recognition, 1-5 
Input after error, 

accepting terminal, 2-275 
disregarding terminal, 
2-274 

Input mode and Edit mode, 
2-71, 2-128 
Input queue, 
batch, 2-188 

placing request in batch, 
2-288 

Inserting control character, 
2-69, 2-126 
Inserting debugging 

information, 2-48, 2-86, 
2-172 
Integer , 

unsigned octal, 2-230 
Interactive process, 2-162 
Interface message processor, 
2-158 

Interrupt , 

CTRL/C, 2-165 
handling CTRL/C, 2-272 
pending, 2-165 
programmed software, 

2-165 

Interrupt system, 2-165 
Invisible , 

making file, 2-274 
INVISIBLE argument, 2-274 
Invisible file, 2-14, 2-258 
Invisible files, 

printing list of, 2-108 
INVISIBLE subcommand, 2-108 
IPCF capabilities, 2-29 
IPCF subcommand, 2-29 
/ISAVE switch, 2-70, 2-126 


JFN , 2-45, 2-160 
JFN , 

Restricted, 2-160 
Job , 

access rights for batch, 
2-295 

advising another, 2-4 
attached, 2-20, 2-184 
batch, 2-158, 2-180 
beginning, 2-179 
canceling batch, 2-40 
changing batch, 2-188 
clearing default switches 
for batch, 2-275 
commands that affect 
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context of, 2-57 
current, 2-19 
current process of, 2-161 
detached, 2-5, 2-19 
device assigned to, 2-158 
disenqaging another, 

2-330 

disengaging current, 

2-102 

ending, 2-184 
engaging, 2-19 
finding out accumulated 
CPU time of, 2-301 
finding out accumulated 
runtime of, 2-301 
finding out command used 
by, 2-301 

finding out connected 
directory of, 2-300 
finding out controlling 
job of, 2-300 
finding out CPU 

percentages alloted to 
and used by each, 2-300 
finding out information 
about, 2-300 

finding out program used 
by, 2-301 

finding out scheduler 
class of, 2-300 
finding out state of, 

2-301 

finding out time limit 
for, 2-300 
finishing, 2-184 
fork of, 2-150 
giving commands to 
another, 2-4 
hung, 2-102 

inefficiency of detached, 
2-102 

information for operator, 
2-304 

information on system and, 
2-156 

jobname of batch, 2-293 
logging out another, 

2-184 

modifying card limit of 
batch, 2-191 
modifying paper tape 
limit of batch, 2-192 
modifying plotter limit 
of batch, 2-195 
modifying print limit of 
batch, 2-194 
modifying priority of 
batch, 2-195 
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nested batch, 2-181 
notification upon 

satisfaction of batch, 
2-291 

phoned-in, 2-19 
process of, 2-150 
request ID number of 
batch, 2-293 
setting defaults for 
nested batch, 2-295 
specifying account for 
batch, 2-289 
specifying account for 
printing, 2-227 
specifying card limit for 
batch, 2-290 
specifying connected 
directory for batch, 
2-290 

specifying dependency 
count for batch, 2-290 
specifying jobname for 
batch, 2-291 
specifying log file of 
batch, 2-291, 2-295 
specifying operator 
assistance for batch, 
2-290 

specifying owner of batch, 
2-293 

specifying paper tape 
limit for batch, 2-290 
specifying priority of 
batch, 2-292 

specifying starting line 
for batch, 2-290 
specifying starting time 
for batch, 2-290 
specifying TAG: : for 
batch, 2-292 

specifying time limit for, 
2-278 

specifying uniqueness of 
batch, 2-293 
submitting batch, 2-288 
talking to batch, 2-311 
talking to PTYCON., 2-311 
time limit of batch, 

2-293 

treatment of log file of 
batch, 2-290, 2-291 
using group rights for 
batch, 2-295 
using SET commands in 
batch, 2-280 
waiting, 2-102 
Job after crash, 

resubmitting batch, 2-291 


JOB argument, 2-161 
Job concurrently, 

processing batch, 2-195 
Job consecutively, 

processing batch, 2-196 
Job for SYSTAT, 

specifying detached, 

2-300 

Job number, 2-184 

printing, 2-161, 2-179 
Job number for SYSTAT, 
specifying, 2-300 
Job of job, 

finding out controlling, 
2-300 

Job options, 

specifying, 2-269 
Job parameters, 
setting, 2-269 
Job slot, 2-102 

log-in on last available, 
2-182 

JOB subcommand, 2-300 
Job switch, 2-216, 2-225, 
2-233 

Job switches, 1-3 
JOB-STATUS argument, 2-161 
JOB-STATUS command, 

INFORMATION, 2-271, 2-275 
2-277 

Job-wide parameters, 2-241 
Jobname, 2-188 

requests with same, 2-195 
Jobname argument, 2-39 
Jobname for batch job, 
specifying, 2-291 
Jobname for print request, 
specifying, 2-228 
Jobname of batch job, 2-293 
Jobname of output request, 
2-230 

Jobname of request, 2-164 
/JOBNAME switch, 2-39, 2-41 
2-192, 2-218, 2-228, 
2-236, 2-291 
/JOBNAME switch, 
using, 2-196 
JSYS , 

SETSN , 2-167 


KEEP subcommand, 2-95 
Keeping track of 

subdirectories, 2-33 
Keeping track of volids, 
2-206 

Keywords, 1-4 

KILL subcommand, 2-29, 2-95 
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Killing directory, 2-34 


~L, 2-317 

LA120 argument, 2-318 
LA30 argument, 2-318 
LA36 argument, 2-318 
LA38 argument, 2-318 
Label type for magnetic 
tape , 

specifying, 2-200 
/LABEL-TYPE switch, 2-200 
Labeled magnetic tape, 

2-284 

specifying protection 
code for, 2-201 
/LANGUAGE-SWITCHES switch, 
2-48, 2-173 
Large files, 

printing list of, 2-108 
LARGER subcommand, 2-108 
Last available job slot, 
log-in on, 2-182 
Last log-in, 

date and time of, 2-160 
LATE-CLEAR-TYPEAHEAD, 2-181 
LATE-CLEAR-TYPEAHEAD 
argument, 2-274 
NO, 2-275 

LATE-CLEAR-TYPEAHEAD 
command , 

SET, 2-159 

LATE-CLEAR-TYPEAHEAD 
parameter, 2-159 
Length , 

magnetic tape record, 
2-167 

specifying limit for 
paper tape, 2-236 
specifying magnetic tape 
record, 2-278 
specifying page, 2-319 
Length 0, 

page, 2-319 

LENGTH argument, 2-319 
Length of entry vector, 
location and, 2-161 
Length of file, 
printing, 2-108 
LENGTH subcommand, 2-108 
LEOT, 

skipping past, 2-284 
LEOT argument, 2-283 
Level , 

creating lower TOPS-20 
command, 2-241 
Level of TOPS-20, 

creating new, 2-241 


Level of TOPS-20 (Cont.) 
current, 2-165, 2-180, 
2-279 

getting new, 2-223 
terminating current, 

2-223 

Levels of subdirectories, 
2-33 

Levels of TOPS-20, 

current and lower, 2-257 

Library , 

object file, 2-88, 2-142, 
2-173 

system, 2-88, 2-142, 

2-173 

/LIBRARY switch, 2-87, 

2-141, 2-173 

Limit , 

maximum storage, 2-33 
modifying CPU time, 2-195 
output, 2-164 
permanent disk storage, 
2-32 

removing time, 2-276 
specifying CPU time, 

2-293 

specifying page, 2-227, 
2-291 

specifying plotter time, 
2-293 

working and permanent 
page, 2-159 
working and permanent 
storage, 2-159 
working disk storage, 

2-32 

LIMIT argument, 2-301 

Limit for batch job, 

specifying card, 2-290 
specifying paper tape, 
2-290 

Limit for job, 

finding out time, 2-300 
specifying time, 2-278 

Limit for paper tape length, 
specifying, 2-236 

Limit for plotter time, 
specifying, 2-218 

Limit of batch job, 
modifying card, 2-191 
modifying paper tape, 

2-192 

modifying plotter, 2-195 
modifying print, 2-194 
time, 2-293 

Limit of output request, 
modifying page, 2-193 
page, 2-230 

LIMIT subcommand, 2-300 
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/LIMIT switch, 2-193, 2-218, 
2-228, 2-236 
Line , 

beginning new, 1-4 
dial-up, 2-323 
Line for batch job, 
specifying starting, 

2-290 

Line number for SYSTAT, 
specifying, 2-300 
Line numbers for file, 
printing, 2-71, 2-127 
suppressing, 2-71, 2-127 
Line numbers from file, 
stripping, 2-71, 2-128 
Line numbers in file, 2-69, 
2-126 

Line printer, 2-164, 2-166 
Line printer, 

sending SYSTAT output to, 
2-300 

Line printer forms, 
modifying, 2-192 
specifying, 2-227 
Line printer output queue, 
2-225 

Line speed, 

terminal, 2-323 
LINE subcommand, 2-300 
LINE-HALFDUPLEX argument, 
2-319 

Linefeed, 2-230 

echoing TAB and, 2-317, 
2-319 

LINES argument, 2-158 
AVAILABLE, 2-158 
LINK program, 2-89, 2-143, 
2-175, 2-326 
Linked user, 

signaling, 2-310 
Linking four terminals 

simultaneously, 2-310 
Linking terminals, 2-310 
Links, 2-168 

ending communication, 

2-24 

receiving communication, 
2-246 

refusing communication, 
2-250 

LINKS argument, 2-246, 

2-250 
List , 

search, 2-244 
List of archived files, 
printing, 2-107 
List of deleted files, 
printing, 2-108 


List of files, 

double-spaced, 2-108 
printing alphabetical, 
2-107 

printing chronological, 
2-107 

printing headline for, 
2-108 

List of invisible files, 
printing, 2-108 
List of large files, 
printing, 2-108 
List of new files, 
printing, 2-109 
List of old files, 
printing, 2-107 
List of outdated files, 
printing, 2-108 
List of small files, 
printing, 2-110 
LIST subcommand, 2-29 
/LIST switch, 2-49, 2-87, 
2-141, 2-166, 2-173 
Listing , 

cross-reference, 2-48, 
2-72, 2-86, 2-141, 

2-172 

Listing of program, 2-49, 
2-173 

Listing of program, 
preventing, 2-142 
printing, 2-87, 2-141 
LNK.MAP, 

file specification, 2-87, 
2-142, 2-173 
Load average, 

explanation of, 2-302 
LOAD command, 2-171, 2-265, 
2-267 

LOAD command switches, 

2-171 

Load point of magnetic tape, 
2-263 

LOAD-class command, 1-1, 

1- 2, 2-47, 2-51, 2-85, 

2- 90, 2-140, 2-144, 
2-166, 2-171 

Loader map, 2-173 

producing, 2-87, 2-142 
Loading debugging program, 
2-81, 2-85 

Loading program, 2-171 
Local log-in, 2-167 
Local switch, 2-225 
Location , 

displaying contents of 
memory, 2-138 
examining memory, 2-138 
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Location (Cont. ) 

modifying memory, 2-99 
Location 120 of entry 
vector, 2-286 
Location 124 of entry 
vector, 2-248 
Location and length of 
entry vector, 2-161 
LOCATION argument, 2-275 
. LOG, 

file type, 2-291 
Log file, 

disposition of, 2-293 
specifying DECnet network 
node for , 2-291 
specifying printing of, 
2-291 

Log file is printed, 
when, 2-294 
Log file is written, 
where, 2-294 
Log file of batch job, 

specifying, 2-291, 2-295 
treatment of, 2-290, 

2-291 

Log file to spooling area 
only , 

writing, 2-294 
Log-in, 2-180 

date and time of last, 
2-160 

kinds of, 2-167 
simplifying, 2-181 
Log-in directory, 1-2, 2-53, 
2-54, 2-180, 2-231, 
2-241, 2-294 
Log-in directory, 

capabilities of, 2-132 
expunging, 2-184 
ownership rights to, 

2-180 

printing, 2-161 
Log-in node, 2-275 
Log-in on last available 
job slot, 2-182 
Log-in user name, 2-1, 2-54, 
2-180 

Log-in within five minutes, 
2-182 

Log-out capability, 
withheld, 2-242 
/LOGDISPOSITION switch, 

2-291 

using, 2-293 
Logging in, 2-180 
Logging in to a 

pseudo-terminal, 2-182 
Logging out another job, 
2-184 


Logical beginning of 

magnetic tape, 2-263 
Logical device name, 2-17 
Logical end of tape, 2-283 
Logical name, 
defining, 2-92 
establishing, 2-92 
removing, 2-92 
system, 2-92 

Logical name definition, 
2-241 

printing, 2-161 
Logical name EDITOR:, 2-72, 
2-129 

Logical name HLP: , 2-154 
Logical name SYS:, 2-92 
LOGICAL-NAMES argument, 

2-161 

LOGIN command, 1-6, 2-179 
LOGIN command, 

implicit access with, 2-1 
LOGIN command arguments, 
2-179 

LOGIN.CMD, 

file specification, 2-180, 
2-323 

LOGIN.CMD file, 2-92 
/LOGNAME switch, 2-291 
LOGOUT command, 2-181, 

2-184, 2-330 
LOGOUT n command, 2-19 
Long filespec, 2-175 
Long-term wait, 2-167 
Lower levels of TOPS-20, 
current and, 2-257 
/LOWER switch, 2-69, 2-126 
Lower TOPS-20 command level, 
creating, 2-241 
LOWERCASE argument, 2-319 
Lowercase character, 2-69, 
2-126, 2-228 
Lowercase character, 

printing, 2-168, 2-319, 
2-320 

/LOWERCASE switch, 2-193, 
2-228 

LPT subcommand, 2-109, 


2-166, 2- 

-300 

LPT : > 2-164, 

2-166 

. LST , 


file type. 

2-229 


/M33 switch, 

2-69, 

2-127 

/M37 switch, 

2-69, 

2-127 

.MAC, 



file type, 

2-50, 

CO 

00 

f 

CM 

2-143, 2 

-174 
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MACRO assembler, 2-49, 2-87, 
2-142, 2-173, 2-326 
/MACRO switch, 2-49, 2-87, 
2-142, 2-17 3 
Magnetic tape, 

DIRECTORY-class command 
for, 2-111, 2-149 
hardware data modes for, 
2-278 

labeled, 2-284 
load point of, 2-263 
logical beginning of, 

2-263 

rewinding, 2-263, 2-334 
specifying drive type for, 
2-200 

specifying label type for, 
2-200 

specifying protection 
code for labeled, 2-201 
unlabeled, 2-284 
unloading, 2-334 
Magnetic tape again, 
accessing, 2-334 
Magnetic tape backward, 
moving, 2-22 
Magnetic tape control 

commands, 2-22, 2-136, 
2-263, 2-283, 2-334 
Magnetic tape density, 

2-167 

specifying, 2-277 
Magnetic tape drive, 2-136 
Magnetic tape format, 2-167 
Magnetic tape format, 
specifying, 2-278 
Magnetic tape forward, 
moving, 2-283 

Magnetic tape parity, 2-167 
specifying, 2-278 
Magnetic tape record length, 
2-167 

specifying, 2-278 
Magnetic tape set, 
dismounting, 2-121 
mounting, 2-199 
Mail , 

system, 2-179 
user, 2-179 

MAIL argument, 2-161, 2-181 
Mail file, 

avoiding checking of, 

2-276 

checking, 2-275 
MAIL program, 2-54, 2-161, 
2-179, 2-275 
MAIL-WATCH argument, 

NO, 2-276 


MAIL . TXT , 

file specification, 2-96, 
2-147, 2-258 
MAIL . TXT file, 2-96 
Mailbox protected, 2-161 
Maintenance capabilities, 
2-29 

MAINTENANCE subcommand , 

2-29 

Making file, 2-68 
Making file invisible, 

2-274 

Making file visible, 2-274 
Making modifiable copy of 
write-protected file, 
2-279 

Making print request, 2-225 
.MAP, 

file type, 2-87, 2-142, 
2-173 

Map, 

loader, 2-173 
producing loader, 2-87, 
2-142 

/MAP switch, 2-87, 2-142, 
2-173 

Mapped file, 2-257 
closing, 2-45 
renaming, 2-255 
Mark , 

end-of-file, 2-136, 2-283 
EOF, 2-107, 2-136, 2-283 
question, 1-6 
Marking file for erasure, 
2-94 
Marks , 

double quotation, 2-194, 
2-228 

quotation, 2-230 
Maximum storage limit, 2-33 
Maximum subdirectories 
allowed, 2-32, 2-159 
MAXIMUM-SUBDIRECTORIES 
subcommand, 2-29 
Mechanical tab stops, 2-168 
Medium argument, 2-121, 
2-199 

Membership , 
group, 2-160 
Memory, 

clearing, 2-152, 2-257 
compressed copy of, 2-78 
copy of, 2-56 
copying program in, 2-78 
fresh copy of, 2-241 
more than one copy of, 
2-241 

number of pages in, 2-167 
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Memory (Cont . ) 

placing executable 
program in, 2-186 
removing pages from, 

2-276 

sharing, 2-78 

Memory for inferior process, 
examining, 2-138 
modifying, 2-100 
Memory location, 

displaying contents of, 
2-138 

examining, 2-138 
modifying, 2-99 
Memory pages, 

assigned, 2-161 
setting page-access of, 
2-100 

MEMORY-USAGE argument, 

2-161 

MEMORY-USAGE command, 

INFORMATION, 2-273, 2-276 
Merge, 2-186 
MERGE command, 2-186 
Merging debugging program, 
2-81 

Messages, 2-54, 2-250 
Messages , 

error, 2-159 
system, 2-168 
/METERS switch, 2-236 
Migrated file, 2-116 
Migration of file, 
allowing, 2-274 
delaying, 2-280 
preventing, 2-274 
MIGRATION. ORDER, 

file specification, 2-280 
Mixing sequenced and 

unsequenced files, 2-10 
Mode , 

FULLDUPLEX, 2-168 
HALFDUPLEX, 2-168 
setting page, 2-319 
Mode of access, 2-160 
Mode of output files, 
modifying, 2-193 
Mode of plotter files, 
specifying, 2-220 
Mode of print request, 
specifying, 2-230 
Mode of punched files, 
specifying, 2-237 
/MODE switch, 2-193, 2-220, 
2-230, 2-237 
Model 33, 

Teletype, 2-317 
Model 35, 

Teletype, 2-317 


Model 37, 

Teletype, 2-317 
Modes for magnetic tape, 
hardware data, 2-278 
Modifiable copy of 

write-protected file, 
making, 2-279 
MODIFY command, 2-158, 

2-164, 2-188 

MODIFY command arguments, 
2-188 

MODIFY command switches, 

2-188 

Modifying byte size of 

printed files, 2-192 
Modifying card limit of 
batch job, 2-191 
Modifying CPU time limit, 
2-195 

Modifying dependency count, 
2-192 

Modifying directory, 2-26, 
2-34 

Modifying first line of 
control file, 2-191 
Modifying first page of 
output, 2-191 
Modifying line printer 
forms, 2-192 
Modifying memory for 

inferior process, 2-100 
Modifying memory location, 
2-99 

Modifying mode of output 
files, 2-193 

Modifying note of output 
request, 2-194 
Modifying number of copies, 
2-191 

Modifying page limit of 

output request, 2-193 
Modifying paper tape limit 
of batch job, 2-192 
Modifying plotter limit of 
batch job, 2-195 
Modifying print limit of 
batch job, 2-194 
Modifying priority of batch 
job, 2-195 

Modifying priority of 

output request, 2-195 
Modifying requests before 
processing, 2-196 
Modifying unit number of 
output device, 2-195 
Module , 

object, 2-50, 2-89, 2-143, 
2-175 
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Module containing start 
address, 2-87, 2-142, 
2-173 

Modules called by program, 
2-88, 2-142, 2-173 
Monitor calls, 

TOPS-IO, 2-165 
TOPS-20, 2-81 
Monitor overhead time, 

2-162 

MONITOR-STATISTICS argument, 
2-162 

Monitoring program, 2-56 
MONSYM . MAC , 

system parameter file, 

2-81 

MOUNT argument, 2-38 
MOUNT command, 2-166, 2-199, 
2-275 

Mount count of structure, 
reducing, 2-120 
Mount request, 
canceling, 2-38 
MOUNT-REQUESTS argument, 
2-163 

Mounted structure, 2-166 
Mounted volumes of tape, 
volids of, 2-168 
Mounting , 

structure unavailable for, 
2-207 

Mounting file structure, 
2-199 

Mounting magnetic tape set, 
2-199 

Mounting tape, 

dummy dev: arguments for, 
2-206 

Moving magnetic tape 
backward, 2-22 
Moving magnetic tape 
forward, 2-283 
MTAn: device, 2-17 
MTn: device, 2-17 
Mutually exclusive 
subcommands, 1-3 


Name, 1-1 

defining logical, 2-92 
directory, 1-1 
establishing logical, 
2-92 

log-in user, 2-180 
printing subdirectory, 
2-159 

printing user, 2-161 
removing logical, 2-92 


Name (Cont . ) 

system logical, 2-92 
translating directory, 
2-326 

Name for SYSTAT, 

specifying user, 2-301 
Name of system, 
printing, 2-168 
NAME-ONLY argument, 2-29 
NAME-ONLY subcommand, 2-33, 
2-159 
name . Qyp , 

file specification, 2-69, 
2-126 
name . Zyp , 

file specification, 2-70, 
2-127 

NBAL , 2-162 

Necessity of R command, 

2-244 

Nested batch job, 2-181 
setting defaults for, 

2-295 

Nested command file, 2-308 
Network , 

ARPA, 2-27, 2-158 
DECnet, 2-159 
transferring files via, 
2-9, 2-63 

Network log-in, 2-167 
Network node, 2-161, 2-275 
Network node, 

setting DECnet, 2-275 
Network node for log file, 
specifying DECnet, 2-291 
Network node for output, 
specifying DECnet, 2-191 
Network node for plotter 
output , 

specifying DECnet, 2-218 
Network node for printed 
output , 

specifying DECnet, 2-227 
Network node for processing, 
specifying DECnet, 2-194, 
2-292 

New account, 

specifying, 2-255 
New file set on existing 
tape set, 
writing, 2-201 
New file set on new tape 
set , 

writing, 2-202 
New files, 

printing list of, 2-109 
New level of TOPS-20, 
creating, 2-241 
getting, 2-223 
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New line, 

beginning, 1-4 
New protection number, 
specifying, 2-255 
New sources only, 

compiling, 2-88, 2-143, 
2-174 

/NEW switch, 2-201 
New tape set, 

writing new file set on, 
2-202 

nnnLNK . MAP , 

file specification, 2-87, 
2-142, 2-173 

NO argumen't, 2-292, 2-319 
NO CONTROL-C -CAPABILITY 
argument, 2-275 
NO COPY-ON-WRITE argument, 
2-276 

NO DEFAULT argument, 2-275 
NO FILE-LINES subcommand, 
2-109 

NO LATE-CLEAR-TYPEAHEAD 
argument, 2-275 
NO MAIL-WATCH argument, 

2-276 

No page, 2-162 
NO PROHIBIT argument, 2-274 
NO subcommand, 2-301, 2-307 
NO SUMMARY-LINES subcommand, 
2-109 

NO TIME-LIMIT argument, 

2-276 

NO UUO-SIMULATION argument, 
2-276 

NO WRITE argument, 2-276 
/NOBAK switch, 2-69, 2-127 
/NOBINARY switch, 2-49 
/NOCOMPILE switch, 2-49, 
2-87, 2-142, 2-173 
Node , 

host, 2-275 
log-in, 2-275 
network, 2-161, 2-275 
setting DECnet network, 
2-275 

Node for log file, 

specifying DECnet network, 
2-291 

Node for output, 

specifying DECnet network, 
2-191 

Node for plotter output, 

specifying DECnet network, 
2-218 

Node for printed output, 

specifying DECnet network, 
2-227 


Node for processing, 

specifying DECnet network, 
2-194, 2-292 

Node for punched output, 
specifying DECnet, 2-235 
/NODEBUG switch, 2-49, 2-87, 
2-173 

/NODECIDE switch, 2-69, 

2-127 

NODES argument, 

DECNET, 2-159 
/NOHEADER switch, 2-193, 
2-220, 2-230, 2-238 
/NOLIBRARY switch, 2-87, 
2-142, 2-173 

/NOLIST switch, 2-49, 2-87, 
2-142, 2-173 
NOLOG argument, 2-291 
Non-alphanumer ic character, 
2-228 

Non-alphanumer ic characters, 
2-194 

Non-unique abbreviation, 

1-6 

NONE subcommand, 2-271 
NONEXISTENT argument, 2-276 
Nonexistent page status, 

2-99 

/NONSEPARATORS switch, 2-70, 
2-127 

Nonstandard file type, 2-50, 
2-88, 2-143, 2-174 
/NONUMBER switch, 2-70, 

2-127 

/NOOPTIMIZE switch, 2-49, 
2-87, 2-142, 2-173 
NOPARITY argument, 2-9, 

2-62 

NORMALLY argument, 2-56 
/NOSEARCH, 2-173 
/NOSEARCH switch, 2-88, 

2-142 

NOT OPENED, 2-160 
Note for plotter request, 
specifying, 2-218 
Note for print request, 
specifying, 2-228 
Note for punch request, 
specifying, 2-236 
Note of output request, 
modifying, 2-194 
/NOTE switch, 1-2, 2-164, 
2-194, 2-218, 2-228, 
2-236 

Notification upon 

satisfaction of batch 
job, 2-291 
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Notification upon 

satisfaction of plotter 
request, 2-219 
Notification upon 

satisfaction of print 
request, 2-228 
Notification upon 

satisfaction of punch 
request, 2-236 
/NOTIFY switch, 2-219, 

2-228, 2-236, 2-291 
/NOUNLOAD switch, 2-201 
/NOVICE switch, 2-70, 2-127 
/NOWAIT switch, 2-119, 

2-201 

NRUN , 2-162 
Number , 
avoiding 

project-programmer , 

2-327 

directory, 2-30, 2-159 
generation, 1-1 
group, 2-160 
job, 2-184 
page, 2-162 
printing job, 2-161, 

2-179 

printing 

pro ject -prog rammer , 

2-326 

printing terminal, 2-179 
request ID, 2-38, 2-163, 
2-166, 2-188 

specifying new protection, 
2-255 

specifying sequence, 

2-195, 2-291 
terminal, 2-161 
translating 

project-programmer , 

2-326 

NUMBER argument, 2-203 
Number for plotter request, 
specifying sequence, 

2-219 

Number for print request, 
specifying sequence, 

2-229 

Number for punch request, 
specifying sequence, 

2-236 

Number for SYSTAT, 

specifying job, 2-300 
specifying line, 2-300 
Number of batch job, 
request ID, 2-293 
Number of copies, 
modifying, 2-191 


Number of disks in 
structure, 2-166 
Number of output device, 
modifying unit, 2-195 
Number of pages in memory, 
2-167 

Number of plotter, 

specifying unit, 2-219 
Number of printer, 

specifying unit, 2-229 
Number of punch, 

specifying unit, 2-236 
Number of request, 
sequence, 2-164 
Number of successive PUSH 
commands, 2-241 
NUMBER subcommand, 2-30 
/NUMBER switch, 2-70, 2-127 


Object file, 2-47, 2-171 
Object file, 

current, 2-49, 2-86, 2-87, 
2-141, 2-142, 2-172, 
2-173 

forcing use of, 2-88, 

2-142 

generating, 2-48 
globally optimized, 2-49, 
2-87, 2-142, 2-173 
Object file library, 2-88, 
2-142, 2-173 

Object module, 2-50, 2-89, 
2-143, 2-175 
Object program, 2-171 
object. MAP, 

file specification, 2-87, 
2-142, 2-173 
OCTAL argument, 2-193, 

2-230 

Octal integer, 
unsigned, 2-230 
ODD argument, 2-278 
ODD parity, 2-167 
Off-line file, 2-277 

permanent copy of, 2-13 
waiting for retrieval of, 
2-277 

Off-line file to disk, 
restoring, 2-258 
Off-line status of file, 
2-259 

Off-transition, 
ready line, 2-158 
OFFLINE subcommand, 2-109 
Old files, 

printing list of, 2-107 
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/OLD switch, 2-70, 2-127 
On-transition , 

ready line, 2-158 
Open device, 2-160 
Open file, 2-146, 2-160 
Open file, 

accessing, 2-83 
BACKSPACE with, 2-22 
closing, 2-45, 2-136 
removing, 2-95 
renaming, 2-255 
SKIP with, 2-283 
OPERATOR argument, 2-301, 
2-304 

Operator assistance for 
batch job, 
specifying, 2-290 
Operator capabilities, 2-30 
Operator is present, 
whether, 2-167 
Operator job, 

information for, 2-304 
OPERATOR subcommand, 2-30 
/OPERATOR switch, 2-201 
using, 2-205 
OPR program, 2-223 
/OPTIMIZE switch, 2-49, 

2-88, 2-172 

Optimized object file, 
globally, 2-49, 2-87, 
2-142, 2-173 

/OPTION switch, 2-70, 2-127 
Options , 

specifying job, 2-269 
Ordering subcommand, 2-109 
Ordinary disk file, 2-259 
Outdated files, 

printing list of, 2-108 
Outdated generations of 
f ile , 

finding, 2-108 
Output , 

modifying first page of, 
2-191 

safeguarding terminal, 
2-250 

specifying DECnet network 
node for, 2-191 
specifying DECnet network 
node for plotter, 2-218 
specifying DECnet network 
node for printed, 2-227 
specifying DECnet node 
for punched, 2-235 
Output action, 
spooled, 2-64 
Output device, 

modifying unit number of, 
2-195 


Output files, 

modifying mode of, 2-193 
Output limit, 2-164 
Output of TYPE command, 
stopping, 2-328 
Output queue, 2-188 
card punch, 2-233 
line printer, 2-225 
paper tape punch, 2-233 
plotter, 2-216 
Output request, 
canceling, 2-40 
changing, 2-188 
charging, 2-54 
jobname of, 2-230 
modifying note of, 2-194 
modifyinq page limit of, 
2-193 

modifying priority of, 
2-195 

page limit of, 2-230 
printing, 2-164 
spooled, 2-166, 2-277 
OUTPUT subcommand, 2-109, 
2-166, 2-301 
/OUTPUT switch, 2-291 
using, 2-293 
Output to line printer, 
sending SYSTAT, 2-300 
OUTPUT-REQUESTS argument, 
2-164 

Overhead time, 
monitor, 2-162 
Overlay , 

page, 2-186 
Owner of batch job, 
specifying, 2-293 
Owner of plotter request, 
specifying, 2-219 
Owner of print request, 
specifying, 2-229 
Owner of punch request, 
specifying, 2-236 
Ownership rights to 

directory, 2-1, 2-53, 
2-134 

Ownership rights to log-in 
directory, 2-180 


; P attribute, 2-64 , 2-255 
P command of EDIT program, 
2-70, 2-127 

/P switch of CREF program, 
2-76 

PA1050.EXE, 

file specification, 2-278, 
2-326 
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Package , 

TOPS-IO compatibility, 
2-165, 2-278, 2-326 
Page , 

file, 2-162 
No, 2-162 

preventing write access 
of, 2-276 
private, 2-162 
PRIVATE, 2-162 
providing private copy of, 
2-276 

specifying execute access 
of, 2-276 

specifying header, 2-229 
specifying read access of, 
2-276 

specifying starting, 

2-229 

specifying write access 
of, 2-276 

PAGE argument, 2-319 
Page counts, 

differing, 2-147 
Page fault, 2-167 
Page length, 

specifying, 2-319 
Page length 0, 2-319 
Page limit, 

specifying, 2-227, 2-291 
working and permanent, 
2-159 

Page limit of output 
request, 2-230 
modifying, 2-193 
Page mode, 

setting, 2-319 
Page number, 2-162 
Page of plotter request, 
specifying header, 2-219 
specifying starting, 

2-219 

Page overlay, 2-186 
Page status, 

Copy-on-write, 2-99 
nonexistent, 2-99 
Page width, 

specifying, 2-322 
PAGE-ACCESS argument, 2-276 
PAGE-ACCESS command, 
effect of SET, 2-278 
Page-access of memory pages, 
setting, 2-100 
Pages, 

assigned, 2-160 
assigned disk storage, 
2-160 

assigned memory, 2-161 
deleted, 2-160 


Pages freed, 
disk, 2-147 
Pages from memory, 
removing, 2-276 
Pages in memory, 
number of, 2-167 
Pages on file structure, 
unused, 2-160 

/PAGES switch, 2-194, 2-291 
Paper tape length, 

specifying limit for, 
2-236 

Paper tape limit for batch 
job, 

specifying, 2-290 
Paper tape limit of batch 
job, 

modifying, 2-192 
Paper tape punch, 2-62, 
2-164 

Paper tape punch, 

switch defaults for, 

2-238 

Paper tape punch forms, 
specifying, 2-235 
Paper tape punch output 
queue, 2-233 

Paper tape punch request, 
canceling, 2-38 
Paper tape reader, 2-8, 

2-62 

PAPER-TAPE, 

clearing default switches 
for PUNCH, 2-275 
PAPER-TAPE argument, 2-38, 
2-188, 2-233, 2-272 
Paper-tape-handling device, 
2-63 

Parameter file MONSYM . MAC , 
system, 2-81 
Parameters , 

job-wide, 2-241 
setting job, 2-269 
Parity , 

EVEN, 2-167 
magnetic tape, 2-167 
ODD, 2-167 

specifying magnetic tape, 
2-278 

PARITY argument, 2-9, 2-62 
PARITY argument, 

TAPE, 2-278 
PARITY command, 

SET TAPE, 2-207 
Passing switches to 
compiler, 2-173 
Password , 

specifying, 2-30, 2-179, 
2-273 
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PASSWORD argument, 

DIRECTORY, 2-273 
Password of directory, 

2-159 

PASSWORD subcommand, 2-30 
PAUSE argument, 2-320 
Pending interrupt, 2-165 
Pending retrieval requests, 
2-165 

Percentages alloted to and 
used by each job, 
finding out CPU, 2-300 
Periodically , 

saving backup file, 2-72, 
2-129 

Permanent attribute, 2-147 
file with, 2-96 
Permanent copy of off-line 
file, 2-13 

Permanent disk storage 

capacity, 2-30, 2-184 
Permanent disk storage 
limit, 2-32 
Permanent page limit, 
working and, 2-159 
Permanent storage limit, 
working and, 2-159 
PERMANENT subcommand, 2-30 
Permanently erased, 
file, 2-332 
Phoned-in job, 2-19 
Physically removing 
structure, 2-121 
Placing executable program 
in memory, 2-186 
Placing request in batch 
input queue, 2-288 
PLEASE program request, 

2-275 

/PLINES switch, 2-70, 2-127 
PLOT, 

clearing default switches 
for, 2-275 

PLOT argument, 2-38, 2-188, 
2-272 

PLOT command, 2-164, 2-216 
PLOT command switches, 

2-216 

Plotter, 2-164, 2-166 
Plotter , 

specifying unit number of, 
2-219 

switch defaults for , 

2-220 

Plotter files, 

specifying mode of, 2-220 
Plotter forms, 

specifying, 2-218 


Plotter limit of batch job, 
modifying, 2-195 
Plotter output, 

specifying DECnet network 
node for, 2-218 
Plotter output queue, 2-216 
Plotter request, 
canceling, 2-38 
notification upon 

satisfaction of, 2-219 
specifying copies of, 

2-219 

specifying header page of, 
2-219 

specifying note for , 

2-218 

specifying owner of, 

2-219 

specifying priority for, 
2-219 

specifying sequence 
number for, 2-219 
specifying starting page 
of, 2-219 
Plotter time, 

specifying limit for, 

2-218 

Plotter time limit, 
specifying, 2-293 
PLT : , 2-164, 2-166 
Plus signs between 

filespecs, 2-50, 2-89, 
2-143, 2-175 
Pointer , 

byte, 2-160 
file, 2-160 
indirect, 2-162 
Pointer to file, 
tape, 2-116 

POP command, 2-45, 2-57, 
2-207, 2-223, 2-242, 
2-255 

/PRESERVE switch, 2-220, 
2-230, 2-238, 2-292 
Preserving .CRF file, 2-76 
Preventing compilation of 
source file, 2-88, 
2-142, 2-173 
Preventing listing of 
program, 2-142 
Preventing migration of 
file, 2-274 

Preventing unedited copy of 
file, 2-69, 2-126 
Preventing write access of 
page, 2-276 

Previous contents of file, 
replacing, 2-255 
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PRINT, 

clearing default switches 
for, 2-275 

PRINT argument, 2-188, 

2-272, 2-275 

PRINT command, 2-164, 2-166, 
2-225 

PRINT command, 

using SET DEFAULT, 2-231 

PRINT command switches, 

2-225 

Print limit of batch job, 
modifying, 2-194 

Print request, 
canceling, 2-38 
making, 2-225 
notification upon 

satisfaction of, 2-228 
specifying copies of, 

2-229 

specifying format of, 

2-229 

specifying jobname for, 
2-228 

specifying mode of, 2-230 
specifying note for, 

2-228 

specifying owner of, 

2-229 

specifying sequence 
number for, 2-229 
specifying spacing of, 
2-230 

Printed files, 

modifying byte size of, 
2-192 

Printed output, 

specifying DECnet network 
node for, 2-227 
Pr inter , 

line, 2-164, 2-166 
sending SYSTAT output to 
line, 2-300 

specifying unit number of, 
2-229 

Printer forms, 

modifying line, 2-192 
specifying line, 2-227 
Pr inting , 

deleting file after, 

2-229 

saving file after, 2-230 
Printing account, 2-161 
Printing account for file, 
2-107, 2-112 

Printing alphabetical list 
of files, 2-107 
Printing checksum 

calculation, 2-107 


Printing chronological list 
of files, 2-107 
Printing connected 
directory, 2-161 
Printing current day, date, 
and time, 2-80 
Printing dates of file, 
2-108 

Printing file on terminal, 
2-328 

Printing headline for list 
of files, 2-108 
Printing headline for 
SYSTAT, 2-300 

Printing information about 
file, 2-105 
Printing job, 

specifying account for, 
2-227 

Printing job number, 2-161, 
2-179 

Printing length of file, 
2-108 

Printing line numbers for 
file, 2-71, 2-127 
Printing list of archived 
files, 2-107 

Printing list of deleted 
files, 2-108 

Printing list of invisible 
files, 2-108 
Printing list of large 
files, 2-108 

Printing list of new files, 
2-109 

Printing list of old files, 
2-107 

Printing list of outdated 
files, 2-108 
Printing list of small 
files, 2-110 

Printing listing of program, 
2-87, 2-141 

Printing log-in directory, 
2-161 

Printing logical name 
definition, 2-161 
Printing lowercase 

character, 2-168, 2-319, 
2-320 

Printing name of system, 
2-168 

Printing of log file, 
specifying, 2-291 
Printing output request, 
2-164 

Printing project-programmer 
number, 2-326 


Index-36 



INDEX (CONT.) 


Printing protection code 
for file, 2-109 
Printing protection number 
of file, 2-109 
Printing size of file, 

2-110 

Printing subdirectory name, 
2-159 

Printing tabs, 2-320 
Printing terminal number, 
2-179 

Printing times of file, 

2-110 

Printing uppercase 

characters, 2-317 
Printing user name, 2-161 
Printing user of file, 

2-110 

Printing version of current 
program, 2-168 
Printing version of system, 
2-168 

Printing version of UUO 
package, 2-168 
Priority, 

specifying, 2-227 
Priority for plotter 
request , 

specifying, 2-219 
Priority for punch request, 
specifying, 2-236 
Priority of batch job, 
modifying, 2-195 
specifying, 2-292 
Priority of output request, 
modifying, 2-195 
/PRIORITY switch, 2-164, 
2-194, 2-219, 2-228, 
2-236, 2-292 
Private copy of page, 
providing, 2-276 
Private page, 2-162 
PRIVATE page, 2-162 
Private structure, 2-166 
Privileged disregard of 
REFUSE, 2-251 
Process , 

compute-bound, 2-162 
continuing inferior, 

2-138 

CPU-bound, 2-162 
examining memory for 
inferior, 2-138 
finding current, 2-168 
finishing current, 2-257 
finishing inferior, 2-257 
interactive, 2-162 
modifying memory for 
inferior, 2-100 


Process (Cont . ) 

returning to superior, 
2-223 

specifying, 2-150 
specifying correct, 2-168 
Process of job, 2-150 
current, 2-161 
Process slot, 2-102 
Processes , 

competition between, 

2-242 

Processing , 

modifying requests before, 
2-196 

specifying DECnet network 
node for, 2-194, 2-292 
Processing batch job 

concurrently, 2-195 
Processing batch job 

consecutively, 2-196 
Processing command file, 
2-307 

/PROCESSING-NODE switch, 
2-158, 2-194, 2-292 
Processor time, 

TOPS-20 command, 2-165 
Program , 

abnormal termination of, 
2-45 

alternate entry point of, 
2-248 

changing entry vector of, 
2-273 

CHECKD , 2-95 
COBDDT , 2-88 
COBDDT.EXE, 2-81 
continuing, 2-56, 2-102 
CREF, 2-326 

DDT, 2-88, 2-99, 2-138, 
2-172 

DDT debugging, 2-86 
debugging, 2-174 
debugging FORTRAN, 2-89 
editing, 2-72, 2-129 
entry vector of, 2-286 
executable, 2-70, 2-127, 
2-152 

executing, 2-140 
FILCOM, 2-155, 2-326 
FORDDT , 2-88 
higher-level, 2-57 
LINK, 2-89, 2-143, 2-175, 
2-326 

listing of, 2-49, 2-173 
loading, 2-171 
loading debugging, 2-81, 
2-85 

MAIL, 2-54, 2-161, 2-179, 
2-275 
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merging debugging, 2-81 
modules called by, 2-88, 
2-142, 2-173 
monitoring, 2-56 
object, 2-171 
OPR, 2-223 

preventing listing of, 
2-142 

printing listing of, 2-87, 
2-141 

printing version of 
current, 2-168 
PTYCON , 2-223, 2-242 
RDMAIL , 2-161 
reentering, 2-102 
resuming execution of, 

2-56 

running executable, 2-244, 
2-265 

running system, 2-244 
saving, 2-267 
SDDT.EXE, 2-81 
source, 2-47, 2-171 
starting executable, 

2-286 

storing frequently run, 
2-265 

suspended, 2-102 
suspending, 2-271 
symbols in, 2-81 
SYS : SDDT . EXE , 2-81 
SYSrUDDT.EXE, 2-81 
TOPS-10, 2-168, 2-276, 
2-279, 2-326 
TV editing, 2-72, 2-129 
UDDT.EXE, 2-81 
Program command level, 2-56 
Program in memory, 
copying, 2-78 
placing executable, 2-186 
Program request, 

PLEASE, 2-275 
PROGRAM subcommand, 2-301 
Program used by job, 
finding out, 2-301 
Program with command file, 
running, 2-308 
Program writing to TTY:, 
2-102 

PROGRAM-STATUS argument, 
2-165 

PROGRAM-STATUS command, 
INFORMATION, 2-279 
Programmed software 
interrupt, 2-165 
Programs , 

debugging, 2-129 


Programs competing for file, 
2-57 

Programs competing for 
files, 2-242 
Programs competing for 
input, 2-57, 2-242 
PROHIBIT argument, 2-274 
PROHIBIT command, 

SET FILE, 2-280 
Project-programmer number, 
avoiding, 2-327 
printing, 2-326 
translating, 2-326 
Prompt , 

$, 2-114, 2-132 
@, 2-114, 2-132, 2-179 
at sign, 2-114, 2-132 
dollar sign, 2-114, 2-132 
PROTECTION argument, 2-274 
DIRECTORY, 2-273 
Protection code, 

default file, 2-28, 2-159 
directory, 2-28, 2-31, 
2-159 

file, 2-28 
specifying, 2-273 
specifying default, 2-272 
Protection code for file, 
printing, 2-109 
specifying, 2-64, 2-274 
Protection code for labeled 
magnetic tape, 
specifying, 2-201 
Protection number, 

specifying new, 2-255 
Protection number of file, 
printing, 2-109 
PROTECTION subcommand, 2-31, 
2-109 

/PROTECTION switch, 2-201 
Providing private copy of 
page, 2-276 
PS:, 1-1, 1-2, 2-180 
PS: LOGIN.CMD, 

file specification, 2-180 
PS : SWITCH . INI , 

file specification, 2-127 
Pseudo-terminal , 

logging in to a, 2-182 
Pseudo-terminal log-in, 

2-167 

PSI system, 2-165 
PSI-STATUS argument, 2-165 
PTP : , 2-62, 2-164 
PTR : , 2-8, 2-62 
PTY : , 2-182 
advising, 2-5 
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PTYCON job, 

talking to, 2-311 
PTYCON program, 2-223, 

2-242 

Public structure, 1-1, 

2-166 
Punch , 

card, 2-164, 2-166 
paper tape, 2-62, 2-164 
specifying unit number of, 
2-236 

switch defaults for card, 
2-238 

switch defaults for paper 
tape, 2-238 
PUNCH CARDS, 

clearing default switches 
for, 2-275 
Punch cards, 

specifying set of, 2-272 
PUNCH command, 2-164, 2-233 
PUNCH command switches, 

2-234 

Punch forms, 

specifying card, 2-235 
specifying paper tape, 
2-235 

Punch output queue, 
card, 2-233 
paper tape, 2-233 
PUNCH PAPER-TAPE, 

clearing default switches 
for, 2-275 
Punch request, 

canceling card r 2-38 
canceling paper tape, 

2-38 

notification upon 

satisfaction of, 2-236 
specifying copies of, 

2-237 

specifying header section 
of, 2-237 

specifying note for, 

2-236 

specifying owner of, 

2-236 

specifying priority for, 
2-236 

specifying sequence 
number for, 2-236 
Punched files, 

specifying mode of, 2-237 
Punched output, 

specifying DECnet node 
for, 2-235 

PURGE subcommand, 2-146 
PUSH command, 2-56, 2-181, 
2-223, 2-241, 2-279 


PUSH commands, 

number of successive, 
2-241 


Question mark, 1-6 
Queue , 

batch input, 2-188 
card punch output, 2-233 
line printer output, 

2-225 

output, 2-188 
paper tape punch output, 
2-233 

placing request in batch 
input, 2-288 
plotter output, 2-216 
scheduler, 2-162 
spooler, 2-40 
Queue-class command, 1-2 
Quota , 

assigning infinite, 2-33 
Quota of superior directory, 
2-33 
Quotas , 

disk, 2-110 

Quotation marks, 2-230 
double, 2-194, 2-228 
• QyPf 

editing files of type, 
2-129 

file type, 2-69, 2-126 


R, 2-162 

R command, 2-244 

necessity of, 2-244 
/R switch, 2-70, 2-127 
RAISE argument, 2-320 
Rate , 

baud, 2-168 
setting baud, 2-320 
RDMAIL program, 2-161 
Read access, 2-160 
Read access of page, 
specifying, 2-276 
Read access to directory, 
2-295 

READ argument, 2-107, 2-110, 
2-276 

READ subcommand, 2-271 
Read-only session of EDIT 
program, 2-71, 2-127 
/READ-ONLY switch, 2-202 
Reader , 

paper tape, 2-62 
/READER switch, 2-292 
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/READONLY switch, 2-70, 
2-127 

Ready line off-transition, 
2-158 

Ready line on-transition, 
2-158 

REBUILD subcommand, 2-146 
Rebuilding symbol table, 
2-146 

RECEIVE command, 2-246, 
2-250 

RECEIVE command arguments, 
2-246 

Receiving advice, 2-246 
Receiving communication 
links, 2-246 

Receiving system messages, 
2-246 

Recognition input, 1-5 
Recognizing argument, 1-5 
Record length, 

magnetic tape, 2-167 
specifying magnetic tape, 
2-278 

RECORD-LENGTH argument, 
TAPE, 2-278 
RECORD-LENGTH command, 

SET TAPE, 2-207 
RECORDS argument, 2-283 
Recovering deleted archived 
file, 2-96 

Reducing charge for SYSTAT, 
2-303 

Reducing mount count of 
structure, 2-120 
Reducing response time for 
SYSTAT, 2-302 
REENTER argument, 2-102 
REENTER command, 2-248 
Reentering program, 2-102 
Refusal of advice, 
implicit, 2-251 
REFUSE, 

privileged disregard of, 
2-251 

REFUSE command, 2-250 
REFUSE command arguments, 
2-250 

Refusing advice, 2-250 
Refusing communication 
links, 2-250 

Refusing system messages, 
2-250 
.REL, 

file type, 2-89, 2-143, 
2-171, 2-175 

Relocatable binary file, 
2-47 


/RELOCATABLE switch, 2-88, 
2-142, 2-173 
Remark , 

session, 2-161 
specifying session, 2-179, 
2-277 

REMARK command, 2-252 
/REMARK switch, 2-120, 

2-202 

Remote log-in, 2-167 
/REMOVE switch, 2-120 
Removing damaged file, 2-95 
Removing logical name, 2-92 
Removing open file, 2-95 
Removing pages from memory, 
2-276 

Removing structure, 
physically, 2-121 
Removing time limit, 2-276 
RENAME, 

efficiency of, 2-254 
RENAME command, 1-2, 2-254 
Renaming archived file, 

2-255 

Renaming mapped file, 2-255 
Renaming open file, 2-255 
REPEAT-LOGIN-MESSAGES 
subcommand, 2-31 
Replacing previous contents 
of file, 2-255 
/REPORT switch, 2-194, 

2-230 

Report writer, 

COBOL, 2-194, 2-230 
Request , 

canceling archival, 2-38 
canceling card punch, 

2-38 

canceling filled 
tape-mount, 2-41 
canceling mount, 2-38 
canceling output, 2-40 
canceling paper tape 
punch, 2-38 

canceling plotter, 2-38 
canceling print, 2-38 
canceling retrieval, 2-38 
canceling SUBMIT command, 
2-38 

changing output, 2-188 
charging batch, 2-54 
charging output, 2-54 
charging SUBMIT command, 
2-54 

implied retrieval, 2-259 
jobname of, 2-164 
jobname of output, 2-230 
making print, 2-225 
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Request (Cont . ) 

modifying note of output, 
2-194 

modifying page limit of 
output, 2-193 
modifying priority of 
output, 2-195 
notification upon 

satisfaction of plotter, 
2-219 

notification upon 

satisfaction of print, 
2-228 

notification upon 

satisfaction of punch, 
2-236 

page limit of output, 

2-230 

PLEASE program, 2-275 
printing output, 2-164 
sequence number of, 2-164 
specifying copies of 
plotter, 2-219 
specifying copies of 
print, 2-229 
specifying copies of 
punch, 2-237 
specifying format of 
print, 2-229 

specifying header page of 
plotter, 2-219 
specifying header section 
of punch, 2-237 
specifying jobname for 


print, 2 - 

-228 


spec if y ing 

mode of print, 

2-230 



specifying 

note for 


plotter , 

2-218 


specifying 

note for 

pr int , 

2-228 



specifying 

note for 

punch , 

2-236 



specifying 

owner of 


plotter , 

2-219 


specifying 

owner of 

print, 

2-229 



specifying 

owner of 

punch , 

2-236 



specifying 

priority 

for 

plotter , 

2-219 


specifying 

pr ior ity 

for 

punch, 2- 

-236 


specifying 

sequence 



number for plotter, 
2-219 

specifying sequence 

number for print, 2-229 
specifying sequence 


Request (Cont . ) 

number for punch, 2-236 
specifying spacing of 
print, 2-230 

specifying starting page 
of plotter, 2-219 
spooled output, 2-166, 
2-277 

structure-mount, 2-163 
tape-mount, 2-163 
Request ID argument, 2-38, 
2-188 

Request ID number, 2-38, 
2-163, 2-166, 2-188 
Request ID number of batch 
job, 2-293 

Request in batch input 
queue , 

placing, 2-288 
Requests , 

pending retrieval, 2-165 
Requests before processing, 
modifying, 2-196 
Requests with same jobname, 
2-195 

Reserving device, 2-17 
RESET command, 2-45, 2-255, 
2-257 

Resources , 

charges for system, 2-180 
/RESTARTABLE switch, 2-194, 
2-292 

Restoring deleted file, 

2-332 

Restoring group rights, 2-1, 
2-134 

Restoring off-line file to 
disk, 2-258 
Restricted JFN, 2-160 
Restricting SYSTAT 

information, 2-301 
Resubmitting batch job 
after crash, 2-291 
Resuming execution of 
program, 2-56 
RETAIN subcommand, 2-13 
Retention count, 

default generation, 2-273 
specifying generation, 
2-273 

Retention count of file, 
specifying generation, 
2-274 

Retrieval of off-line file, 
waiting for, 2-277 
Retrieval request, 
canceling, 2-38 
implied, 2-259 
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Retrieval requests, 
pending, 2-165 
RETRIEVAL-REQUESTS argument, 
2-165 

Retrieval-wait, 

automatic, 2-259, 2-277 
RETRIEVAL-WAIT argument, 
2-277 

RETRIEVE argument, 2-38 
RETRIEVE command, 2-258 
Retrieved file, 
using, 2-259 
Returning device, 2-83 
Returning to superior 
process, 2-223 
REVERSE subcommand, 2-109 
REWIND command, 2-263 
REWIND command switches, 
2-263 

Rewinding magnetic tape, 
2-263, 2-334 
Rights , 

group, 2-180 
obtaining group, 2-53 
restoring group, 2-1, 

2-134 

Rights for batch job, 
access, 2-295 
using group, 2-295 
Rights of directory owner, 
group, 2-1, 2-134 
Rights to directory, 
ownership, 2-1, 2-53, 

2-134 

Rights to log-in directory, 
ownership, 2-180 
/RONLY switch, 2-70, 2-127 
RUN, 2-301 

efficiency of, 2-265 
RUN command, 2-265 
Run program, 

storing frequently, 2-265 
Run set, 2-162 
/RUN switch, 2-70, 2-127 
Running COBOL program again, 
2-286 

Running executable program, 
2-244, 2-265 
Running program with 

command file, 2-308 
Running system program, 

2-244 

Runtime, 2-167 
Runtime of job, 

finding out accumulated, 
2-301 


S command of EDIT program, 
2-69, 2-126 
Safeguarding terminal 
output, 2-250 

Satisfaction of batch job, 
notification upon, 2-291 
Satisfaction of plotter 
request , 

notification upon, 2-219 
Satisfaction of print 
request , 

notification upon, 2-228 
Satisfaction of punch 
request , 

notification upon, 2-236 
SAVE command, 2-267, 2-279 
/SAVE switch, 2-70, 2-128 
Saving backup file 

periodically, 2-72, 
2-129 

Saving control file, 2-292 
Saving file after printing, 
2-230 

Saving program, 2-267 
Saving recent generations 
of file, 2-95 
Saving unedited copy of 
file, 2-69, 2-126 
Scheduler class of job, 
finding out, 2-300 
Scheduler queue, 2-162 
/SCRATCH switch, 2-202 
SDDT.EXE program, 2-81 
Search list, 2-244 
/SEARCH switch, 2-88, 2-142 
Section of punch request, 
specifying header, 2-237 
Sending comments only, 

2-252 

Sending SYSTAT information 
to file, 2-301 
Sending SYSTAT output to 
line printer , 2-300 
SEPARATE subcommand, 2-109 
Separators , 

field, 2-70, 2-127, 2-128 
/SEPARATORS switch, 2-71, 
2-128 

Sequence number , 

specifying, 2-195, 2-291 
Sequence number for plotter 
request , 

specifying, 2-219 
Sequence number for print 
request , 

specifying, 2-229 
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Sequence number for punch 
request , 

specifying, 2-236 
Sequence number of request, 
2-164 

/SEQUENCE switch, 2-39, 

2-71, 2-128, 2-195, 

2-219, 2-229, 2-236, 
2-292 

Sequenced and unsequenced 
files, 

mixing, 2-10 
SEQUENTIALLY argument, 

2-107 
Session , 

current terminal, 2-279 
Session remark, 2-161 

specifying, 2-179, 2-271, 
2-277 

SESSION-REMARK argument, 
2-277 

Set , 

balance, 2-162 
dismounting magnetic tape, 
2-121 

mounting magnetic tape, 
2-199 

run, 2-162 

single-volume tape, 2-206 
SET command, 2-180, 2-241, 
2-269 

SET command arguments, 

2-269 

SET commands for debugging, 
using, 2-280 

SET commands in batch job, 
using, 2-280 

SET DEFAULT PRINT command, 
using, 2-231 

SET DEFAULT SUBMIT command, 
using, 2-294 
SET DIRECTORY commands, 
using, 2-281 
SET PAGE-ACCESS command, 
effect of, 2-278 
SET TIME-LIMIT command, 
using, 2-279 
Setname, 2-204 

tape, 2-119, 2-200 
SETSN JSYS , 2-167 
Setting baud rate, 2-320 
Setting DECnet network node, 
2-275 

Setting defaults for nested 
batch job, 2-295 
Setting job parameters, 

2-269 

Setting page mode, 2-319 


Setting page-access of 
memory pages, 2-100 
Setting terminal speed, 

2-320, 2-323 

Sharing copy of file, 2-78 
Sharing memory, 2-78 
Signaling linked user, 

2-310 
Signals , 

CTRL/G, 2-246, 2-250, 

2-310 

Simplifying log-in, 2-181 
Simulating formfeed, 2-317 
Simulating tabs, 2-320 
Simultaneously, 

linking four terminals, 
2-310 

SINCE subcommand, 2-109 
SINGLE argument, 2-230 
Single-volume tape set, 

2-206 

SIXBIT argument, 2-278 
SIXBIT text, 

COBOL, 2-229 
Size , 

byte, 2-160 
working set, 2-167 
Size of file, 

printing, 2-110 
Size of printed files, 
modifying byte, 2-192 
SIZE subcommand, 2-110 
SKIP command, 2-283 
SKIP with open file, 2-283 
Skipping past LEOT, 2-284 
Slash, 1-2 
Slot, 

job, 2-102 

log-in on last available 
job, 2-182 
process, 2-102 
Small files, 

printing list of, 2-110 
SMALLER subcommand, 2-110 
SNAMES, 2-167 
SNBLKS , 2-167 
Socket number, 
absolute, 2-27 
Software interrupt, 
programmed, 2-165 
Source file, 2-8, 2-47, 

2-61, 2-171 
Source file, 

forcing compilation of, 
2-48 

preventing compilation of, 
2-88, 2-142, 2-173 
translating, 2-47 
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Source files, 
editing, 2-129 
Source program, 2-47, 2-171 
Space \ 

address* 2-56 
forgetting file, 2-95 
swapping, 2-102 
withholding freed disk, 
2-95 

Spacing of print request, 
specifying, 2-230 
/SPACING switch, 2-195, 

2-230 

Special access condition, 
2-160 

Specification, 

changing file, 2-254 
DIRECTORY. OWNER file, 

2-13 

file, 1-1 

Specification BATCH.CMD, 
file, 2-180, 2-295 
Specification COMAND.CMD, 
file, 2-180, 2-231, 2-241, 
2-279, 2-294 
Specification DIR. DIR, 
file, 2-109 \ 

Specification 

DIRECTORY. OWNER, ' 
file, 2-95 

Specification LNK . MAP ,/ 
file, 2-87, 2-142, 2-173 
Specification LOGIN.CMD, 
file, 2-180, 2-323 
Specification MAIL.TXT, 
file, 2-96, 2-147, 2-258 
Specification 

MIGRATION. ORDER, 
file, 2-280 

Specification name.Qyp, 
file, 2-69, 2-126 
Specification name.Zyp, 
file, 2-70, 2-127 
Specification nnnLNK.MAP, 
file, 2-87, 2-142, 2-173 
Specification object. MAP, 
file, 2-87, 2-142, 2-173 
Specification PA1050.EXE, 
file, 2-278, 2-326 
Specification PS : LOGIN. CMD , 
file, 2-180 

Specification PSrSWITCH.INI, 
file, 2-127 

Specification SWITCH.INI, 
file, 2-127, 2-129 
Specification SYSTAT.LST, 
file, 2-301 
Specifying parameter, 
see name of parameter 


Speed , 

sett .ng terminal, 2-320 , 
2-323 

terminal, 2-168 
terminal line, 2-323 
SPEED argument, 2-320 
Speeds , 

using split, 2-323 
SPFLTS , 2-167 
Split speeds, 
using, 2-323 
SPOOL argument, 2-290 
Spooled output action, 2-64 
Spooled output request, 
2-166, 2-277 
/SPOOLED-OUTPUT switch, 

2-40, 2-221, 2-231, 

2-238 

S POOLED-OUTPUT-ACT I ON , 
INFORMATION, 2-277 
SPOOLED -OUTPUT -ACT I ON 

argument, 2-166, 2-277 
SPOOLED -OUT PUT -ACT I ON 
command , 

SET, 2-166 
Spooler queue, 2-40 
Spooling area only, 
writing log file to, 

2-294 

SRV: , 2-63 
SSIZE, 2-167 

Standard file type, 2-48, 

2-50, 2-87, 2-88, 2-141, 
2-143, 2-173, 2-174 
Start address, 

module containing, 2-87, 
2-142, 2-173 
START argument, 2-102, 

2-203 

START command, 2-248, 2-265, 
2-286 

/START switch, 2-71, 2-128, 
2-203 
Start-up, 

system, 2-162 

Starting executable program, 
2-286 

Starting line for batch job, 
specifying, 2-290 
Starting page, 

specifying, 2-229 
Starting page of plotter 
request , 

specifying, 2-219 
Starting time, 

specifying, 2-217, 2-227, 
2-235 

Starting time for batch job, 
specifying, 2-290 
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Starting volume for tape 
use , 

specifying, 2-203 
STATE argument, 2-301 
State of job, 

finding out, 2-301 
STATE subcommand, 2-301 
Statement tracing, 2-89 
Status , 

Copy-on-write page, 2-99 
nonexistent page, 2-99 
Status of file, 
archive, 2-157 
off-line, 2-259 
STAY argument, 2-56 
STAY command, 

CONTINUE, 2-241 
/STEP switch, 2-71, 2-128 
STIMES, 2-167 
Stops , 

mechanical tab, 2-168 
Storage capacity, 
infinite, 2-33 
permanent disk, 2-30, 
2-184 

working disk, 2-32 
Storage limit, 
maximum, 2-33 
permanent disk, 2-32 
working and permanent, 
2-159 

working disk, 2-32 
Storage pages, 

assigned disk, 2-160 
Storing frequently run 
program, 2-265 
Stripping line numbers from 
file, 2-71, 2-128 
Structure, 1-1 
connected, 1-1 
dismounting, 2-121 
domestic, 2-166 
file, 1-1 
foreign, 2-166 
mounted, 2-166 
mounting file, 2-199 
number of disks in, 2-166 
physically removing, 

2-121 

private, 2-166 
public, 1-1, 2-166 
reducing mount count of, 
2-120 

unused pages on file, 
2-160 

STRUCTURE argument, 2-119, 
2-166, 2-199 

Structure identification, 
2-119, 2-163 


Structure identification, 
specifying, 2-203 
Structure unavailable for 
mounting, 2-207 
/STRUCTURE-ID switch, 2-120, 
2-203 

/STRUCTURE-ID switch, 
using, 2-121, 2-205 
Structure-mount request, 
2-163 

Subcommand, 1-3 
ABORT, 2-27 
ACCOUNT, 2-107 
ACCOUNT-DEFAULT, 2-27 
AFTER, 2-271 
ALL, 2-271, 2-300 
ALLOW, 2-307 
ALPHABETICALLY, 2-107 
ARCHIVE, 2-94 
ARCHIVED, 2-107 
ARPANET-WIZARD, 2-27 
ASCII, 2-8, 2-61 
BEFORE, 2-107 
BINARY, 2-8, 2-61 
BYTE, 2-8, 2-62 
CHECKSUM, 2-107 
CHRONOLOGICAL, 2-107 
CLASS, 2-300 
CONFIDENTIAL, 2-28 
CONTENTS-ONLY, 2-94 
CONTROLLING, 2-300 
CRAM, 2-107 
DATES, 2-108 

DEFAULT-FILE-PROTECTION , 
2-28 

DELETE, 2-146 
DELETED, 2-108 
DIRECTORY, 2-94, 2-300 
DIRECTORY-GROUP, 2-28 
DISALLOW, 2-307 
DOUBLESPACE, 2-108 
ECHO, 2-307 
ENQ-DEQ , 2-28 
EVERYTHING, 2-108 
EXECUTE, 2-271 
EXPUNGE, 2-94, 2-332 
FAST, 2-159 
FILES-ONLY, 2-28 
FIND, 2-108 
FORGET, 2-95 
GENERATIONS, 2-29 
HEADER, 2-300 
HEADING, 2-108 
IMAGE, 2-9, 2-62 
IMAGE BINARY, 2-9, 2-62 
INVISIBLE, 2-108 
IPCF , 2-29 
JOB, 2-300 
KEEP, 2-95 
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KILL, 2-29, 2-95 
LARGER, 2-108 
LENGTH, 2-108 
LIMIT, 2-300 
LINE, 2-300 
LIST, 2-29 

LPT, 2-109, 2-166, 2-300 
MAINTENANCE, 2-29 
MAXIMUM-SUBDIRECTORIES , 
2-29 

NAME-ONLY, 2-33, 2-159 
NO, 2-301 

NO FILE-LINES, 2-109 
NO SUMMARY-LINES, 2-109 
NONE, 2-271 
NUMBER, 2-30 
OFFLINE, 2-109 
OPERATOR, 2-30 
OUTPUT, 2-109, 2-166, 
2-301 

PASSWORD, 2-30 
PERMANENT, 2-30 
PROGRAM, 2-301 
PROTECTION, 2-31, 2-109 
PURGE, 2-146 
READ, 2-271 
REBUILD, 2-146 
REPEAT-LOGIN-MESSAGES , 
2-31 

RETAIN, 2-13 
REVERSE, 2-109 
SEPARATE, 2-109 
SINCE, 2-109 
SIZE, 2-110 
SMALLER, 2-110 
STATE, 2-301 
SYSTEM, 2-301 
TIME, 2-301 
TIMES, 2-110 
USER, 2-110, 2-301 
USER-GROUP, 2-31 
VERBOSE, 2-159 
WHAT, 2-301 
WHEEL, 2-31 
WHERE, 2-301 
WHO, 2-301 
WORKING, 2-32 
WRITE, 2-271 
Subcommands, 1-1 

APPEND command, 2-8 
ARCHIVE command, 2-13 
BUILD command, 2-26 
COPY command, 2-61 
DELETE command, 2-94 
DIRECTORY command, 2-105 
EXPUNGE command, 2-146 
mutually exclusive, 1-3 
SYSTAT command, 2-299 


Subcommands (Cont.) 

TAKE command, 2-307 
Subcommands on command line, 
SYSTAT, 2-303 
Subdirectories, 

keeping track of, 2-33 
levels of, 2-33 
Subdirectories allowed, 
maximum, 2-32, 2-159 
Subdirectory name, 
printing, 2-159 
Subdirectory owners, 

granting capabilities to, 
2-34 
SUBMIT, 

clearing default switches 
for, 2-275 

SUBMIT argument, 2-272, 

2-275 

SUBMIT command, 2-158, 

2-288 

SUBMIT command, 

using SET DEFAULT, 2-294 
SUBMIT command request, 
canceling, 2-38 
charging, 2-54 
SUBMIT command switches, 
2-288 

Submitting batch job, 2-288 
Submitting card images as 
control file, 2-292 
Subordinate directory, 2-26 
Subsystem, 2-167 
SUBSYSTEM-STATISTICS 
argument, 2-167 
Summary lines, 

suppressing, 2-109 
Superior directory, 2-32 
highest-level, 2-33 
quota of, 2-33 
Superior process, 
returning to, 2-223 
SUPERSEDE argument, 2-290 
SUPPRESS argument, 2-193, 
2-230 

Suppressing file lines, 

2-109 

Suppressing headline, 2-109 
Suppressing line numbers 
for file, 2-71, 2-127 
Suppressing summary lines, 
2-109 

Surrendering device, 2-83 
Suspended program, 2-102 
Suspending capabilities, 

2-114 

Suspending program, 2-271 
Swap-read, 2-162 
Swap-write, 2-162 
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Swapping space, 2-102 
Switch , 

/68-COBOL , 2-48, 2-86, 
2-141, 2-172 
/74-COBOL, 2-48, 2-86, 
2-141, 2-172 
/ACCOUNT, 2-217, 2-227, 
2-235, 2-289 

/AFTER, 1-2, 2-164, 2-190, 
2-217, 2-227, 2-235, 
2-289 

/ALGOL, 2-48, 2-86, 2-141, 
2-172 

/ALL, 2-158, 2-163, 2-164, 
2-165 

/ASSISTANCE, 2-290 
/BAR, 2-69, 2-126 
/BATCH-LOG, 2-290 
/BEGIN, 2-191, 2-219, 
2-229, 2-290 
/BINARY, 2-48 
/C128 , 2-69, 2-126 
/C64 , 2-69, 2-126 
/CARDS, 2-191, 2-290 
/CHECK-SETNAME , 2-200 
/COBOL, 2-48, 2-86, 2-141, 
2-172 

/COMPILE, 2-48, 2-86, 
2-141, 2-172 
/CONNECTED-DIRECTORY, 

2-290 

/COPIES, 2-191, 2-219, 
2-229, 2-237 

/CREF, 2-48, 2-72, 2-86, 
2-141, 2-172 
/CURRENT-VOLUME-ONLY, 

2-263 

/DDT, 2-86, 2-172 
/DEBUG, 2-49, 2-86, 2-142, 
2-172, 2-173 
/DECIDE, 2-69, 2-126 
default, 1-3 
/DELETE, 2-191, 2-219, 
2-229, 2-237, 2-290 
/DENSITY, 2-200 
/DEPENDENCY-COUNT, 2-191, 
2-196, 2-290 

/DESTINATION-NODE, 2-191, 
2-218, 2-227, 2-235, 
2-275, 2-291 
/DPY , 2-69, 2-126 
/DRIVE -TYPE, 2-200 
/ENTIRE -VOLUME-SET, 2-263 
/EXPERT, 2-69, 2-126 
/FAST, 2-158, 2-163, 

2-164, 2-165 
/FEET, 2-192, 2-291 
file, 2-216, 2-225, 2-233 
/FILE, 2-192, 2-229 
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/FORMS, 2-164, 2-192, 
2-218, 2-227, 2-235 
/FORTRAN, 2-48, 2-87, 
2-141, 2-173 
/GENERIC, 2-192, 2-218, 
2-228, 2-235 

global, 2-47, 2-85, 2-140, 
2-225 

/HEADER, 2-192, 2-219, 
2-229, 2-237 
/INCREMENT, 2-69, 2-126 
/ISAVE, 2-70, 2-126 
job, 2-216, 2-225, 2-233 
/JOBNAME, 2-39, 2-41, 
2-192, 2-218, 2-228, 
2-236, 2-291 
/LABEL-TYPE, 2-200 
/LANGUAGE-SWITCHES, 2-48, 
2-173 

/LIBRARY, 2-87, 2-141, 
2-173 

/LIMIT, 2-193, 2-218, 
2-228, 2-236 

/LIST, 2-49, 2-87, 2-141, 
2-166, 2-173 
local, 2-225 
/LOGDISPOS ITION , 2-291 
/LOGNAME, 2-291 
/LOWER, 2-69, 2-126 
/LOWERCASE, 2-193, 2-228 
/M33 , 2-69, 2-127 
/M37, 2-69, 2-127 
/MACRO, 2-49, 2-87, 2-142, 
2-173 

/MAP, 2-87, 2-142, 2-173 
/METERS, 2-236 
/MODE, 2-193, 2-220, 

2-230, 2-237 
/NEW, 2-201 
/NOBAK, 2-69, 2-127 
/NOBINARY, 2-49 
/NOCOMPILE, 2-49, 2-87, 
2-142, 2-173 
/NODEBUG, 2-49, 2-87, 

2-173 

/NODECIDE , 2-69, 2-127 
/NOHEADER, 2-193, 2-220, 
2-230, 2-238 

/NOLIBRARY, 2-87, 2-142, 
2-173 

/NOLIST, 2-49, 2-87, 

2-142, 2-173 
/NONSEPARATORS, 2-70, 

2-127 

/NONUMBER, 2-70, 2-127 
/NOOPTIMIZE, 2-49, 2-87, 
2-142, 2-173 
/NOSEARCH, 2-88, 2-142 
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/NOTE, 1-2, 2-164, 2-194, 
2-218, 2-228, 2-236 
/NOTIFY, 2-219, 2-228, 
2-236, 2-291 
/NOUNLOAD, 2-201 
/NOVICE, 2-70, 2-127 
/NOWAIT, 2-119, 2-201 
/NUMBER, 2-70, 2-127 
/OLD, 2-70, 2-127 
/OPERATOR, 2-201 
/OPTIMIZE, 2-49, 2-88, 
2-172 

/OPTION, 2-70, 2-127 
/OUTPUT, 2-291 
/PAGES, 2-194, 2-291 
/PLINES, 2-70, 2-127 
/PRESERVE, 2-220, 2-230, 
2-238, 2-292 

/PRIORITY, 2-164, 2-194, 
2-219, 2-228, 2-236, 
2-292 

/PROCESSING-NODE, 2-158, 
2-194, 2-292 
/PROTECTION, 2-201 
/R, 2-70, 2-127 
/READ-ONLY, 2-202 
/READER, 2-292 
/READONLY, 2-70, 2-127 
/RELOCATABLE, 2-88, 2-142, 
2-173 

/REMARK, 2-120, 2-202 
/REMOVE, 2-120 
/REPORT, 2-194, 2-230 
/RESTARTABLE , 2-194, 

2-292 

/RONLY, 2-70, 2-127 
/RUN, 2-70, 2-127 
/SAVE, 2-70, 2-128 
/SCRATCH, 2-202 
/SEARCH, 2-88, 2-142 
/SEPARATORS, 2-71, 2-128 
/SEQUENCE, 2-39, 2-71, 
2-128, 2-195, 2-219, 
2-229, 2-236, 2-292 
/SPACING, 2-195, 2-230 
/SPOOLED-OUTPUT, 2-40, 
2-221, 2-231, 2-238 
/START, 2-71, 2-128, 

2-203 

/STEP, 2-71, 2-128 
/STRUCTURE-ID, 2-120, 

2-203 

/SYMBOLS, 2-88, 2-174 
/TAG, 2-292 

/TIME, 1-5, 2-195, 2-292 
/TPLOT , 2-195, 2-293 
/UNIQUE, 2-195, 2-293 
/UNIT, 2-219, 2-229, 
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2-236 

/UNSEQUENCE, 2-71, 2-128 
/UPPER, 2-71, 2-128 
/UPPERCASE, 2-195, 2-229 
/USER, 1-4, 2-40, 2-158, 
2-163, 2-164, 2-165, 
2-195, 2-219, 2-229, 
2-236, 2-293 
using /BATCH-LOG, 2-293 
using /CHECK-SETNAME , 

2-204 

using /JOBNAME, 2-196 
using /LOGDISPOSITION , 
2-293 

using /OPERATOR, 2-205 
using /OUTPUT, 2-293 
using /STRUCTURE-ID, 

2-121, 2-205 
using /VOLIDS, 2-205 
/VOLIDS , 2-203 
/WINDOW, 2-71, 2-128 
/WRITE-ENABLED, 2-203 
Switch defaults for card 
punch, 2-238 

Switch defaults for paper 
tape punch, 2-238 
Switch defaults for plotter, 
2-220 

Switch of CREF program, 

/P, 2-76 
SWITCH . INI , 

file specification, 2-127, 
2-129 

SWITCH . INI file, 2-70, 2-72 
Switches, 1-1, 1-2 
Switches , 

CANCEL command, 2-40 
COMPILE command, 2-47 
CREATE command, 2-68 
DEBUG command, 2-85 
EDIT command, 2-125 
EXECUTE command, 2-140 
global, 1-3 
job, 1-3 

LOAD command, 2-171 
MODIFY command, 2-188 
PLOT command, 2-216 
PRINT command, 2-225 
PUNCH command, 2-234 
REWIND command, 2-263 
specifying default, 2-231, 
2-272, 2-295 
SUBMIT command, 2-288 
Switches assuming 

compilation, 2-50 
Switches for batch job, 
clearing default, 2-275 
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Switches for compiler. 


clearing 

default , 

2-275 

Switches for PLOT, 


clearing 

default , 

2-275 

Switches for PRINT, 


clearing 

default , 

2-275 


Switches for PUNCH CARDS, 
clearing default, 2-275 
Switches for PUNCH 
PAPER-TAPE , 

clearing default, 2-275 
Switches for SUBMIT, 

clearing default, 2-275 
Switches to compiler, 
passing, 2-173 
Symbol table, 2-88, 2-173 
Symbol table, 

rebuilding, 2-146 
Symbols in program, 2-81 
/SYMBOLS switch, 2-88, 

2-174 
SYS : , 

defining, 2-244 
logical name, 2-92 
SYS : SDDT . EXE program, 2-81 
SYS : UDDT . EXE program, 2-81 
SYSTAT, 

printing headline for, 
2-300 

reducing charge for, 

2-303 

reducing response time 
for, 2-302 

specifying detached job 
for, 2-300 

specifying job number for, 
2-300 

specifying line number 
for, 2-300 

specifying system-wide, 
2-300 

specifying user name for, 
2-301 

SYSTAT command, 2-166, 

2-181, 2-279, 2-299 
SYSTAT command subcommands, 
2-299 

SYSTAT information, 
printing all, 2-300 
restricting, 2-301 
sample of, 2-302 
SYSTAT information to file, 
sending, 2-301 
SYSTAT output to line 
pr inter , 
sending, 2-300 
SYSTAT subcommands on 

command line, 2-303 


SYSTAT. LST, 

file specification, 2-301 
System , 

batch, 2-158 
finding out information 
about, 2-300 
interrupt, 2-165 
printing name of, 2-168 
printing version of, 

2-168 

PSI, 2-165 

System accounting, 2-54 
System and job, 

information on, 2-156 
SYSTEM argument, 2-161, 

2-301 

System configuration file, 
2-323 

System crash, 2-194 
System features, 

TOPS-20 , 2-154 
System herald or greeting, 
2-179 

System library, 2-88, 2-142, 
2-173 

System logical name, 2-92 
System mail, 2-179 
System manager , 

defaults set by, 2-230, 
2-293, 2-323 
System messages, 2-168 
receiving, 2-246 
refusing, 2-250 
System parameter file 
MONSYM . MAC , 2-81 
System program, 
running, 2-244 
System resources, 
charges for, 2-180 
System start-up, 2-162 
SYSTEM subcommand, 2-301 
SYSTEM-DEFAULT argument, 
2-277, 2-320 
SYSTEM-DEFAULT format, 

2-167 

SYSTEM-MESSAGES argument, 
2-246, 2-250 
SYSTEM-STATUS argument, 

2-167 

SYSTEM-STATUS command, 
INFORMATION, 2-277 
System-wide SYSTAT, 
specifying, 2-300 


; T attribute, 2-146 
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Tab, 

horizontal, 2-230 
vertical, 2-230 
TAB and linefeed, 

echoing, 2-317, 2-319 
Tab stops, 

mechanical, 2-168 
Table , 

rebuilding symbol, 2-146 
symbol, 2-88, 2-173 
Tabs , 

printing, 2-320 
simulating, 2-320 
TABS argument, 2-320 
/TAG switch, 2-292 
TAG:: for batch job, 
specifying, 2-292 
TAKE argument, 2-272 
TAKE command, 2-181, 2-307 
TAKE command subcommands, 
2-307 

TALK command, 2-246, 2-250, 
2-252, 2-310 

Talking between VT100 and 
VT52 , 2-311 

Talking to another user, 
2-310 

Talking to batch job, 2-311 
Talking to PTYCON job, 

2-311 

Tape, 

carriage control, 2-192, 
2-227 

DIRECTORY-class command 
for magnetic, 2-149 
dummy dev: arguments for 
mounting, 2-206 
hardware data modes for 
magnetic, 2-278 
labeled magnetic, 2-284 
load point of magnetic, 
2-263 

logical beginning of 
magnetic, 2-263 
logical end of, 2-283 
rewinding magnetic, 2-263, 
2-334 

specifying density of, 
2-200 

specifying drive type for 
magnetic, 2-200 
specifying label type for 
magnetic, 2-200 
specifying protection 
code for labeled 
magnetic, 2-201 
unlabeled, 2-22, 2-136, 
2-207 

unlabeled magnetic, 2-284 


Tape (Cont . ) 

unloading magnetic, 2-334 
unloading volume of, 

2-121 

volids of archive, 2-166 
volids of mounted volumes 
of, 2-168 

TAPE argument, 2-119, 2-199, 
2-277 

Tape backward, 

moving magnetic, 2-22 
TAPE command, 

SET, 2-167 

Tape control commands, 
magnetic, 2-22, 2-136, 
2-263, 2-283, 2-334 
Tape copy of file, 2-116 
Tape density, 
magnetic, 2-167 
specifying magnetic, 

2-277 

TAPE DENSITY command, 

SET, 2-207 
Tape drive, 

magnetic, 2-136 
Tape format, 

magnetic, 2-167 
specifying magnetic, 

2-278 

TAPE FORMAT command , 

SET, 2-207 
Tape forward, 

moving magnetic, 2-283 
Tape length, 

specifying limit for 
paper, 2-236 

Tape limit for batch job, 
specifying paper, 2-290 
Tape limit of batch job, 
modifying paper, 2-192 
Tape parity, 

magnetic, 2-167 
specifying magnetic, 

2-278 

TAPE PARITY command, 

SET, 2-207 

Tape pointer to file, 2-116 
Tape punch, 

paper, 2-62, 2-164 
switch defaults for paper, 
2-238 

Tape punch forms, 

specifying paper, 2-235 
Tape punch output queue, 
paper, 2-233 
Tape punch request, 
canceling paper, 2-38 
Tape reader, 

paper, 2-8, 2-62 
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Tape record length, 
magnetic, 2-167 
specifying magnetic, 

2-278 

TAPE RECORD-LENGTH command, 
SET, 2-207 
Tape set, 

dismounting magnetic, 
2-121 

mounting magnetic, 2-199 
single-volume, 2-206 
writing new file set on 
existing, 2-201 
writing new file set on 
new, 2-202 

Tape setname, 2-119, 2-200 
Tape use, 

specifying starting 
volume for, 2-203 
Tape-mount request, 2-163 
canceling filled, 2-41 
TAPE-PARAMETERS argument, 
2-167 

TAPE-PARAMETERS command, 
INFORMATION, 2-277 
TAPE-WRITE argument, 2-107, 
2-110 

TDIRECTORY command, 2-314 
Telephone , 

dialing in by, 2-179 
Teletype Model 33, 2-317 
Teletype Model 35, 2-317 
Teletype Model 37, 2-317 
Temporary file, 2-146 
Terminal , 

freeing hung, 2-330 
printing file on, 2-328 
Texas Instruments, 2-321 
Terminal characteristics, 
specifying, 2-315 
TERMINAL command, 2-168, 
2-180, 2-181, 2-315 
TERMINAL command arguments, 
2-315 

Terminal input after error, 
accepting, 2-275 
disregarding, 2-274 
Terminal line speed, 2-323 
Terminal number, 2-161 
printing, 2-179 
Terminal output, 

controlling, 2-180 
safeguarding, 2-250 
Terminal session, 
current, 2-279 
Terminal speed, 2-168 
setting, 2-320, 2-323 
Terminal type, 2-168 
specifying, 2-316 


Terminal wake-up, 2-162 
TERMINAL-MODE argument, 
2-168, 2-181 
Terminals , 

compatible, 2-5 
linking, 2-310 
Terminals simultaneously, 
linking four, 2-310 
Terminating current level 
of TOPS-20 , 2-223 
Termination of program, 
abnormal, 2-45 
TERMINET argument, 2-321 
Texas Instruments terminal, 
2-321 
Text , 

ASCII, 2-229 
COBOL SIXBIT , 2-229 
explanatory, 2-154 
FORTRAN ASCII, 2-229 
TI, 2-301 

TI argument, 2-321 
Time , 

CPU, 2-162, 2-165 
elapsed, 2-165 
monitor overhead, 2-162 
printing current day, 
date, and, 2-80 
specifying CPU, 2-279 
specifying limit for 
plotter , 2-218 
specifying starting, 

2-217, 2-227, 2-235 
TOPS-20 command processor, 
2-165 

TIME argument, 2-301 
Time for batch job, 
specifying starting, 

2-290 

Time for SYSTAT, 

reducing response, 2-302 
Time limit, 

modifying CPU, 2-195 
removing, 2-276 
specifying CPU, 2-293 
specifying plotter, 2-293 
Time limit for job, 
finding out, 2-300 
specifying, 2-278 
Time limit of batch job, 
2-293 

Time of job, 

finding out accumulated 
CPU, 2-301 
Time of last log-in, 
date and, 2-160 
TIME subcommand, 2-301 
/TIME switch, 1-5, 2-195, 
2-292 
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TIME-LIMIT, 2-181 
TIME-LIMIT argument, 2-278 
NO, 2-276 

TIME-LIMIT command, 
using SET, 2-279 
Time-ordered DIRECTORY 
command, 2-314 
Times of file, 
printing, 2-110 
TIMES subcommand, 2-110 
TOPS-10 compatibility 

package, 2-165, 2-278, 
2-326 

TOPS-10 monitor calls, 

2-165 

TOPS-10 program, 2-168, 
2-276, 2-279, 2-326 
TOPS-20 , 

creating new level of, 
2-241 

current and lower levels 
of, 2-257 

current level of, 2-165, 
2-180, 2-279 
getting new level of, 
2-223 

terminating current level 
of, 2-223 

TOPS-20 argument, 2-200 
TOPS-20 command level, 2-56 
2-57 

TOPS-20 monitor calls, 2-81 
TOPS-20 system features, 
2-154 

/TPLOT switch, 2-195, 2-293 
Tracing , 

statement, 2-89 
Transferring files via 
network, 2-9, 2-63 
TRANSLATE command, 2-326 
Translating directory name, 
2-326 

Translating 

pro ject -prog rammer 
number, 2-326 
Translating source file, 
2-47 

Treatment of log file of 

batch job, 2-290, 2-291 
TRIPLE argument, 2-230 
TTY:, 2-307, 2-311 
TTY: , 

appending from, 2-10 
copying from, 2-64 
program writing to, 2-102 
TV editing program, 2-72, 
2-129 
-typ, 1-1 


Type, 

file, 1-1 

nonstandard file, 2-50, 
2-88, 2-143, 2-174 
specifying terminal, 

2-316 

standard file, 2-87, 2-88 
2-141, 2-143, 2-173, 
2-174 

terminal, 2-168 
Type .ALG, 

file, 2-50, 2-88, 2-143, 
2-174 

TYPE argument, 2-321 
Type . CBL , 

file, 2-50, 2-88, 2-143, 
2-174 

Type . CMD , 
file, 2-307 
TYPE command, 2-328 

stopping output of, 2-328 
Type . CRF , 

file, 2-48, 2-72, 2-86, 
2-141, 2-172 
Type . CTL , 
file, 2-288 
Type .DAT, 
file, 2-229 
Type .DIRECTORY, 
file, 2-33, 2-64 
Type .EXE, 

file, 2-78, 2-152, 2-186, 
2-244, 2-265 
Type .FOR, 

file, 2-50, 2-88, 2-143, 
2-174 

Type for magnetic tape, 
specifying drive, 2-200 
specifying label, 2-200 
Type . HLP , 
file, 2-154 
Type .LOG, 
file, 2-291 
Type . LST , 
file, 2-229 
Type .MAC, 

file, 2-50, 2-88, 2-143, 
2-174 

Type .MAP, 

file, 2-87, 2-142, 2-173 
Type . Qyp , 

editing files of, 2-129 
file, 2-69, 2-126 
Type .REL, 

file, 2-89, 2-143, 2-171, 
2-175 

Type . Zyp , 

file, 2-70, 2-127 
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Typing initial CTRL/C, 
2-179 


UDDT.EXE program, 2-81 
UNATTACH command, 2-181, 
2-330 

Unavailable for mounting, 
structure, 2-207 
UNDELETE command, 2-332 
Undoing DISCARD, 2-117 
Unedited copy of file, 
preventing, 2-69, 2-126 
saving, 2-69, 2-126 
/UNIQUE switch, 2-195, 

2-293 

Uniqueness of batch job, 
specifying, 2-293 
/UNIT, 2-195 
Unit number of output 
device , 

modifying, 2-195 
Unit number of plotter, 
specifying, 2-219 
Unit number of printer, 
specifying, 2-229 
Unit number of punch, 
specifying, 2-236 
/UNIT switch, 2-219, 2-229, 
2-236 

UNLABELED argument, 2-200 
Unlabeled magnetic tape, 
2-284 

Unlabeled tape, 2-22, 2-136, 
2-207 

UNLOAD command, 2-334 
Unloading magnetic tape, 
2-334 

Unloading volume of tape, 
2-121 

/UNSEQUENCE switch, 2-71, 
2-128 

Unsequenced files, 

mixing sequenced and, 

2-10 

Unsigned octal integer, 

2-230 

Unused pages on file 
structure, 2-160 
Updated copy of file, 2-72, 
2-129 

Updating backup copy of 
file, 2-70, 2-126 
/UPPER switch, 2-71, 2-128 
Uppercase character, 2-71, 
2-128, 2-228 
Uppercase character, 
flagging, 2-168 


Uppercase characters, 2-229 
printing, 2-317 
/UPPERCASE switch, 2-195, 
2-229 

Use , 

specifying starting 

volume for tape, 2-203 
Use of object file, 
forcing, 2-88, 2-142 
Used by job, 

finding out command, 

2-301 

finding out program, 

2-301 
User , 

signaling linked, 2-310 
talking to another, 2-310 
User mail, 2-179 
User name, 

log-in, 2-1, 2-54, 2-180 
printing, 2-161 
User name for SYSTAT, 
specifying, 2-301 
User of file, 

printing, 2-110 
USER subcommand, 2-110, 

2-301 

/USER switch, 1-4, 2-40, 
2-158, 2-163, 2-164, 
2-165, 2-195, 2-219, 
2-229, 2-236, 2-293 
USER-GROUP subcommand, 2-31 
Using /BATCH-LOG switch, 
2-293 

Using /CHECK-SETNAME switch, 
2-204 

Using group rights for 
batch job, 2-295 
Using /JOBNAME switch, 

2-196 

Using /LOGD IS POSIT ION 
switch, 2-293 
Using /OPERATOR switch, 

2-205 

Using /OUTPUT switch, 2-293 
Using retrieved file, 2-259 
Using SET commands for 
debugging, 2-280 
Using SET commands in batch 
job, 2-280 

Using SET DEFAULT PRINT 
command, 2-231 
Using SET DEFAULT SUBMIT 
command, 2-294 
Using SET DIRECTORY 
commands, 2-281 
Using SET TIME-LIMIT 
command, 2-279 
Using split speeds, 2-323 
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Using /STRUCTURE-ID switch, 
2-121, 2-205 

Using /VOLIDS switch, 2-205 
UUO package, 

printing version of, 

2-168 

UUO-SIMULATION , 

SET, 2-165 

UUO-SIMULATION argument, 
2-279 
NO, 2-276 

UUO-SIMULATION command, 

SET, 2-165 


Validation , 

account, 2-167 
VDIRECTORY command, 2-336 
Vector , 

entry, 2-186 
location 120 of entry, 
2-286 

location 124 of entry, 
2-248 

location and length of 
entry, 2-161 
Vector of program, 

changing entry, 2-273 
entry, 2-286 
VERBOSE argument, 2-29 
Verbose DIRECTORY command, 
2-336 

VERBOSE subcommand, 2-159 
VERSION argument, 2-168, 
2-181 

Version of current program, 
printing, 2-168 
Version of system, 
printing, 2-168 
Version of UUO package, 
printing, 2-168 
Vertical format character, 
2-230 

Vertical format of forms, 
2-192, 2-277 
Vertical tab, 2-230 
Visible , 

making file, 2-274 
VISIBLE argument, 2-274 
Volids, 2-163 

keeping track of, 2-206 
Volids of archive tape, 
2-166 

Volids of mounted volumes 
of tape, 2-168 
/VOLIDS switch, 2-203 
using, 2-205 


Volume for tape use, 
specifying starting, 

2-203 

Volume identifiers, 2-204 
specifying, 2-203 
Volume of tape, 
unloading, 2-121 
VOLUMES argument, 2-168 
Volumes of tape, 

volids of mounted, 2-168 
VT05 argument, 2-322 
VT100 and VT52, 

talking between, 2-311 
VT100 argument, 2-322 
VT50 argument, 2-322 
VT52 , 

talking between VT100 and, 
2-311 

VT52 argument, 2-322 


W, 2-162 
Wait , 

long-term, 2-167 
Waiting for retrieval of 
off-line file, 2-277 
Waiting job, 2-102 
Wake-up , 

terminal, 2-162 
WHAT argument, 2-301 
WHAT subcommand, 2-301 
Wheel capabilities, 2-31 
WHEEL subcommand, 2-31 
When log file is printed, 
2-294 

WHERE argument, 2-301 
Where log file is written, 
2-294 

WHERE subcommand, 2-301 
Whether operator is present, 
2-167 

WHO argument, 2-301 
WHO subcommand, 2-301 
Width , 

specifying page, 2-322 
WIDTH argument, 2-322 
Wildcard character, 1-2, 
2-10, 2-216, 2-225, 
2-233, 2-254 

Wildcard characters, 2-64 
/WINDOW switch, 2-71, 2-128 
Withdrawing archive status 
of f ile ', 2-116 
Withheld log-out capability, 
2-242 

Withholding freed disk 
space, 2-95 
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Working and permanent page 
limit, 2-159 
Working and permanent 

storage limit, 2-159 
Working disk storage 
capacity, 2-32 
Working disk storage limit, 
2-32 

Working set size, 2-167 
WORKING subcommand, 2-32 
Write access, 2-26, 2-32, 
2-160 

Write access of page, 
preventing, 2-276 
specifying, 2-276 
Write access to directory, 
2-295 

WRITE argument, 2-107, 

2-110, 2-276 
WRITE argument, 

NO, 2-276 

Write date, 2-49, 2-88, 

2-174 

WRITE subcommand, 2-271 
/WRITE-ENABLED switch, 

2-203 

Write-protected file, 

making modifiable copy of, 


2-279 

Writer, 

COBOL report, 2-230 
Writing log file to 

spooling area only, 
2-294 

Writing new file set on 
existing tape set, 

2-201 

Writing new file set on new 
tape set, 2-202 
Writing to TTY : , 
program, 2-102 
WROTE argument, 2-110 


YES argument, 2-292 


Zero , 

fork, 2-150 
• Zyp , 

file type, 2-70, 2-127 
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